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Escalate your controller 
design in style 


Fully configurable universal case system- the perfect fit for all your 
application needs 


Every panel on the UCS enclosure range can be customised enabling you to 


create your own individual stylish design easily. 





With optional wall, desk & DIN rail mounting adaptors the range is available 
in 2 colours, 4 sizes & 2 heights ensuring you'll find the right enclosure for 


your next project. 


For more information visit https://phoe.co/ucs-rpi-uk 
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INSPIRING INNOVATIONS 








WELCOME 
to The MagP1 116 


e’ve spent a lot of time tinkering with Raspberry Pi 
and its wonderful Linux-based operating system, 
Raspberry Pi OS. As a result, we’ve discovered a rich 
seam of hacks, tweaks, and interesting tips that would be plain 
rude not to share. So, this month’s lead feature is Hidden Hacks 
(page 32), where we reveal some of the best things we’ve learnt 
when using Raspberry P1. 

Looking upwards, Rob has an interest in astrophotography, 
and the Shoot for the Stars feature (page 66) explains all about 
capturing the night sky. All you need is Raspberry Pi anda 
powerful - but not necessarily expensive - camera. 

April 2022 marks the 4oth anniversary of another favourite 
computer: Sinclair’s amazing ZX Spectrum. One maker has 
taken Raspberry Pi Zero and squeezed it inside a Spectrum’s 
cassette tape (page 8). Another is using Raspberry Pi to scan 
barcodes on retro games and play them in a retro games Store. 

One more thing: if you’ve ever wanted to learn about the ARM 
processor, be sure to look at the start of a new Set of tutorials by 
Stephen Smith (page 46). Fascinating stuff. 

Hope you enjoy this issue! 
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Lucy 
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Lucy is editor of The 
MagPI and never 
did get the hang of 
Z80 machine code. 


@LucyHattersley 
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Black / White: Black / White / Red: 7-Color 


Support Device 
Raspberry Pi / Pico / Jetson Nano / Arduino / STM32 / ESP32 / ESP8266 / 
PC / Android and iOS Phone (with NFC) 
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Learn Java 





DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pj Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations covering 
many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your jurisdiction 
and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go beyond. It is 
your responsibility to understand the manufacturer's limits. 
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Home projects made easy. 


CDP Studio, a great software development tool for your home projects. Build 
systems for Raspberry Pi, use C++ or NoCode programming, open source libraries, 
(10) axe) int al-u ole) @rs10] 0) ole) aan ke) am] =| O Mm VAGHELY/ LO Im im @) = Om U/W) ale anle)a-Mm@1g-t-1(-mOl-t-1ULGIA0| MUIi-18 
interfaces. Built for industrial control system development, FREE for home projects. 


cdpstudio.com 
Tel: +47 990 80 900 « info@cdptech.com 
CDP Technologies AS // Hundsvzergata 8, 6008 Alesund, Norway 
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ZX Spectrum 
Raspberry P1 Cassette 


Between jobs, one maker decided to push their Raspberry Pi skills and 
make a portable ZX Spectrum Raspberry Pi, Rosie Hattersley approves 





Stuart Brand 





Stuart aka 
JamHamster is “an IT 
Root Cause Engineer 
for work and an avid 
(Some would say 
obsessed) tinkerer in 
my off hours!" 


@RealJamhamster 





to concentrate on pushing his skills by 

building Raspberry Pi projects: “I headed 
to the garage and embraced my inner nerd!” 
exclaims the maker of the ZX Spectrum Raspberry 
Pi Cassette. “I wouldn’t have had a clue how to 
build any of this stuff before lockdown. It goes to 
prove that you never know what you’ re capable of 
until you give it a go.” 

Stuart’s first computer, a ZX Spectrum, has a 
special place in his heart, so a Raspberry Pi project 
based around one seemed ideal. “They’re still great 
machines!” he says of the beloved computer which 
celebrates its 40th birthday this April. 

Stuart loves repairing and running real hardware 
as well as emulations and thought “it would be 


C tuart Brand was between jobs and decided 


A The handcrafted heatsink fits beautifully inside the repurposed cassette tape 
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nifty to see if I could fit an entire ZX Spectrum 
emulator into a cassette tape shell.”” He now uses 
his ZX Spectrum Pi Cassette as a ‘pick up and play 
device whenever he fancies “a quick bash at some 
old school gaming.” 


d 


Learn as you go 

Prior to this project, Stuart had several retro 
makes under his belt and had made a tape 
emulator for an Arduino-based ZX Spectrum +2 
that acts like a multi-cart tape. “Putting a whole 
Spectrum in a tape shell was the next logical step 
and an interesting challenge,” he says. Being 
tight for space, he chose Raspberry Pi Zero W. He 
loves the fact both ZX Spectrum and Raspberry 
Pi’s ARM processor were developed in Cambridge. 


M Stuart wrapped Raspberry 
P| in foil and went at It 
with ad Dremel @ 


Despite this, he describes himself as a haphazard 
tinkerer with little electronics experience, who 
plans everything in his head. “I don’t have any 
schematics to share,” he apologises, “and never 
measure anything.” However, he makes paper 
mock-ups of everything he’s planning, largely to 
ensure it all fits. A veteran of small case builds, 
Stuart cautions other wannabe makers to leave 
far more room for cables than you think you’1l 
need. He also admits to treating his Raspberry Pi 
collection rather roughly: “even though they have 
been abused and tortured, they still keep running.’ 

Stuart assembled the ZX Spectrum Raspberry Pi 
build from what he had to hand. He took a sheet of 
scrap metal and used a bandsaw to fashion a crude 


) 





DietPi and Fuze ZX 
Spectrum emulator 
software is loaded for 
rel Ula al=lald(omRelolol-mer-laallare) 


In this stealth build, a 1980s 
C15 cassette tape houses 
(most of) a Raspberry Pi 
Zero W and a custom-built 
rl kUlaaliallelaamat=r>1ey1 a). 


shape for what would act as Raspberry Pi Zero W’s 
heatsink. A Dremel, needle files, and fine-grit 
Sandpaper were used to finesse the shape. 


Getting it taped 

Stuart bought a job lot of cassette tape seconds: 
“Boots C15 were the cassettes I used for storing my 
programs back in the ’80s; it was an obvious choice” 
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> Stuart enjoys 


creating stealth 
builds that are 
more than 

they appear 


He's itching to 
make a retro 
Raspberry Pi 
boom box 


With a touchscreen 
and drop-in 
cassette loader 


Depending on the 
tape loaded, it 
would play... 


C64, Atari, 
BBC, and ZX 
Spectrum games 






ai al-me)ge)(-re1mmc-r-laelalale 

Raspberry Pi 

Zero W, nanoHUB, \ 
shell, cables, and 
rere) a] a(=1e4 Ke) gfx exe )=) Me | 


— for which he designed and printed new labels. 
“Cassette shells make for a great form factor,” 
says Stuart, “I started with a plain black spare 
cassette shell and used a small hand file and 
side cutters to remove the plastic supports in 
preparation for fitting the heatsink.” 

The 5mm interior of the C15 cassette tape meant 
something would have to give: fitting a Zero W 
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A Stuart has form 
making retro 
gaming builds using 
Raspberry Pi 


> Customised cassette 
labels complete the 
1980s look 
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Boots e15 compater 


Alert! 
Warranty voiding 


This project involves 
cutting off the GPIO pins 
in order to fit Raspberry 
Pi Zero W/ inside a 
cassette tape. This risks 
damaging Pi Zero W 
and invalidates your 
warranty. Wrapping it 
in aluminium foil while 
cutting is a sensible 
precaution. Cut carefully. 
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A. Stuart's cassette edition of 
the ZX Spectrum atop an 
original Spectrum keyboard 


M™| lost some GPIO ports, but 
it was well worth It to get 
the tape looking right @ 


inside involved cutting out a section to nestle 

under the reels and “preserve the illusion” — not 
something inexperienced makers are advised to 
tackle. Stuart has eight similar builds under his belt, 
hence his confidence. He wrapped Raspberry Pi in 
foil and “went at it with a Dremel.” Surprisingly, 

it survived. “I lost some GPIO ports, but it was well 
worth it to get the tape looking right.” 

Configuring the DietPi and Fuze ZX Spectrum 
emulator took lots of tweaks before Stuart was 
able to get them to boot in an acceptable time 
frame. “I eventually got it to boot in 16 seconds. 
The full-width heatsink meant I could safely 
overclock Zero W and saved another couple of 
seconds,” he says. 

His next challenge: a 1980s boom box with 
drop-in cassettes that boot up and play games 
from different iconic home computers. We like 
his thinking! 


PROJECT SHOWCASE | Mag?i 


Make a tape 





Si) Farce. || 





tm | , = on 
| Elle iprtincerncs 


UTATSUTATTANOU TNT 





01 Install DietPi (dietpi.com) and 

the Fuze ZX Spectrum emulator 
(fuse-emulator.sourceforge.net) on your 
Raspberry Pi and set it to autorun at startup. 





02 Create a heatsink following the contours of 

the cassette case, and avoiding the spool area. 
Wrap Raspberry Pi Zero W in aluminium foil and very 
carefully cut off the GPIO port section where it will 
prevent the spool wheels fitting. 


03 Position Raspberry Pi Zero W in the cassette 
shell, then fit the ports. Stuart used GPIO sound 
and an RCA connector for composite video out and 
added a shutdown button on the front of the tape, 
and then hooked it up to a shutdown script. 
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Penkesu Computer 


Pop Raspberry Pi in your pocket and compute on the go with Penk Chen's 


Stunning mini retro computer. David Crookes takes a look 





Penk Chen 





Penk is a software 
engineer and a toy 
hobbyist. He refers 
to himself as a 
digital nomad from 
Taiwan and lives 

in Tokyo with Ruha 
Cheng and two 
cats, Musashi 

and Kojiro. 


penkesu. 
computer 


> Penk says the spray 


paint colours had him 


“stumped”. “Using 
beige feels a bit 
like ‘cheating’ but 
thankfully it turned 
out fine,” he says 


rage, especially among businessmen in the 
1990s. Roughly the size of a spectacles case, 
they allowed people to keep a check on their daily 
activities. But while Penk Chen appears to have 
created his own cool, minimalist version of one 
of those devices, inspiration for his project came 
from elsewhere. 

Penk was looking to build upon his work with 
mechanical keyboards. “I’d learned not only how 
to build them from scratch, or mould and cast my 
own key caps, but also how to use a laser engraver 
to melt pigment onto Key caps to print my own 
legends,” he says. “I recall staring at those low- 
profile key switches and thinking to myself, this 
could make a great retro-style computer”. 

There were two things he wanted above all: 
compact physical dimensions and a nostalgic 
theme. “Back in the 1990s, gadget pencil cases 
were extremely popular among kids in Asia,” he 
says. “I figured if I were to pay homage to the 
past, what could be better than recreating the 


E lectronic organisers were once all-the- 


qt? 
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magical moment of opening a pencil case°” This 
thinking led to the project’s name: Penkesu is the 
Japanese word for ‘pencil case’, while happening to 
reference the maker himself. 


Key to success 

Identifying the appropriate components proved 
relatively easy. “Since this project started with 

the keyboard, finding the other parts was fairly 
straightforward,” Penk affirms. At first, this meant 
looking for a screen to match the size of his 48-key 
mechanical keyboard, and it led him to choosing a 
7.9-inch touchscreen display. 

He then opted for a Raspberry Pi Zero 2 W 
computer. “It was a natural fit,” he says. “Looking 
back at its predecessors, you will find that there’s 
virtually nothing to complain about except to 
marvel at the wonders of modern technology.” The 
rest of the components included a LiPo battery, 
some diodes, and a keyboard-controlling Arduino 
Pro Micro, but designing a 3D-printable case was 
the greatest challenge. 


Making a good case 

“The weight distribution was not an easy task,” 
Penk explains. “The screen is mounted ina 
rather top-heavy fashion, so it took me some 
time to properly design the chassis and place 
counterweights so that it would not tip over when 
opened at its maximum angle.” This was achieved 
by gluing a thin metal sheet to the base. “The 

end result is a low-centre-of-gravity, stable, and 
satisfyingly clicky device,” he adds. 

Interestingly, the project also uses a Set of 
replacement hinges designed for a Game Boy 
Advance SP console, making the device easy to 
open and close while adding extra retro goodness. 
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carries the 

HDMI signal 
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y oval atel aMVdte(stxelk=\=1a > It's designed to 
ol Dol [-yo)F-\vm at toa have as few parts 
resolution of 480 x 1280 as possible 
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> It folds to protect 


the screen, like a 
mini-laptop 


> The keyboard 
uses an 
ortholinear layout 


> The Arduino runs 
the QMK 
keyboard firmware 


The Penkesu has been 
designed with just three 
Tal X=)gatelmexeyanyele)at=val ay 
Raspberry Pi Zero 2 W, 
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V_ The mini-computer 
runs Raspberry Pi 


™ What could be more ee. 
handheld device 
nostalgic than using 
genuine console parts 


from the 1990s? @ 


“What could be more nostalgic than using genuine 
console parts from the 1990s°” he asks. It was then 
a matter of connecting everything up — in this case, 
largely plugging the components together — and 
getting Raspberry Pi to run Raspberry Pi OS for an 
instant mini-machine. 

“Everyone knows that when it comes to 
presenting your build to the interweb community, 
cable management is the most important thing, 
and I’m terrible at soldering,” he laughs, before 
adding that in a world of supply chain disruption, 
it also made the project more viable. “I’m now 
experimenting with the mouse keys feature of QMK 
firmware to see if I can rely on the keyboard more 
when using Raspberry Pi OS,” he says, explaining 
that he’s not finished with this project just yet. 
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Kimberlina Droid 


Selin took inspiration from Star Wars when designing a Raspberry Pl 
Pico-powered battle bot. She talks strategy with Rosie Hattersley 











Selin Ornek 


Selin lives in 
Istanbul and fits 
building robots and 
giving TED talks 
about STEM around 
her schoolwork. Her 
mission is to use Al 
for good. 


selinoid.com 


Selin and Kimberlina 
take to the 
battleground and 
prepare to vanquish 
less speedy foes 





: = 
———— 


tanks with enormous wheels that bear down 

inexorably on their enemies was a fearsome 
sight. The concept seemed ideal to 15-year-old 
robot builder Selin Ornek when she needed ideas 
for anew battlebot. Having already made quite a 
name for herself in the world of coding, Selin was 
likely to have plenty of competitors keen to take 
her down, which partly explains why she named 
her battle bot Kimberlina in tribute to a comedy 


n Star Wars: Attack Of The Clones, a convoy of 


character from TV show Full House that she watched 


in lockdown. Kimberlina may have a quirky name, 
but her strike is deadly! Once you know something 
about Kimberlina’s maker, this won’t be a surprise. 

Selin is an accomplished coder and Raspberry Pi 
robot builder. She began coding aged eight — first 
Scratch, but later Python, Java, and C++ — and 
designed her first robot at ten. 

Her interest in coding began after Selina 
interviewed a family friend, who is a mechanical 
engineer, about building a robot dog as a means 
of bringing her much-loved dog, Korsan, back to 
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life. His advice to learn coding and robotics, plus 
Scratch-based lessons that helped her class learn 
English, set Selin on her robot-building journey. 
She has now built six robots, including two that act 
as guide dog robots for blind people. The original 
version of this, the Arduino-based ICAU, won Selin 
her first prize at Coolest Projects International in 
2018. “I won first place in the Hardware Category 
at Coolest Projects, and one of my prizes was a 
Raspberry Pi 3B+.” The other was a Google ATY kit 
- presented to her by Raspberry Pi’s very own Eben 
Upton. “After this, I started to use Raspberry Pi in 
all my projects.” 

With a firm focus on using technology for good 
and demonstrating that an interest in computing is 
gender-free, Selin won the Aspiring Teen category 
in the 2021 Women In Tech Global Awards 
(magpi.cc/witawards). 


Firm foundations 

Kimberlina began life as a cardboard prototype, 
which helped Selin decide on the parts she was 
going to use. The robot seemed a great opportunity 
to try out Raspberry Pi Pico for the first time, 
since she needed a microcontroller that could run 
motors, servos, and receive Bluetooth signals. 
Selin used the wheel design from her previous 
robot and designed other parts in Autodesk 
Tinkercad. “Because the wheel has a very small 
contact point with the ground, I had to find a way 
to balance the robot when it accelerates forward 
and backwards, so I placed steel ball bearings with 
enough space to move within the robot,” she says. 
The contest in which Kimberlina was to compete 
threw up challenges too, stipulating maximum 
weight and speed limitations. “The weight was a 
challenge after the decision to use ball bearings, 
but choosing the right motors was the key to 
[having] a fast-moving and turning robot.” 
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> Selin began 
learning Scratch 
after enjoying 
Minecraft 


Vv 


Her first original 
design was an 
anti-bullying robot 


> Aged 12, she built 
a guide dog robot 


Kimberlina’s large wheels 
called IC4U 
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This won the 
hardware category 
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Her prize: a 
Raspberry Pi 3B+ 
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M Selin's competition 
Strategy was to move 
quickly and remain agile 
avoiding contact 


Decisions made, Selin 3D-printed and assembled , 
Kimberlina’s body, using the time available while SS 
the body parts were printing to design a mobile Zz : Pp y INNOVATION DOLLARS. | 
app in MIT App Inventor to control the droid over _ Sos} 5.900, 000.0 
Bluetooth. She used MicroPython to code Raspberry 
Pi Pico and the hardware connected to it. Once the 
coding was complete and the robot was assembled, 
it was time to test it. “I was lucky,” says Selin of how 
her meticulous planning and experience played out. 
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4@ |C4U2 is a Raspberry Pi robot 
guide dog, one of six robots 
Selin has designed to date 





& Having built five other 
robots, Selin knew exactly 
fe What circuitry to use 


—— a for Kimberlina 


4 A powerful punch and 
speedy wheels make 
Kimberlina a fearsome 
robot opponent 


4€ Kimberlina being weighed 
prior to the competition 


2021/3/23 19:01 
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01 Sketch out your design and make a 
cardboard prototype to help you work out the 

overall dimensions, how everything will be powered, 

and the connections needed. 
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Coolest Projects in 2018 


vid Bluetooth from a RE TS 
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mobile application @ 


“Usually my robots do not work immediately. I 
come across a problem and sometimes even burn 
a part, but fortunately, Kimberlina worked on the 
first try.” 


02 Use CAD software to design the robot's body, 
leaving space for Raspberry Pi Pico and any 

batteries or cables, then 3D-print or otherwise build 

the casing. 












Speed and control 
Kimberlina is controlled via Bluetooth from a 
mobile application Selin built using MIT App 
Inventor. A servo at the front controls the flipper 
to flip an opponent, while the servo at the back is 
attached to a lever that pushes the opponent away. 
“Kimberlina has great balance thanks to steel 
ball bearings that help centre it. This means that 
when it gets a hit or accelerates fast, it doesn’t roll 
over,” explains Selin. “My competition strategy 
was to move quickly and remain agile, avoiding 
contact, and make the other robots fall from the 03 

; to create a means of controlling your battlebot. 
platform without touching them,” she adds. Set Raspberry Pi's URL as the destination and add 
The mighty wheels of Hailfire, coupled with the :1880/ mit. An alternative is to use Node-RED and 
portable power of Raspberry Pi Pico, proved an control Raspberry Pi directly. 
unbeatable combination. Hl 





Use the web component of MIT App Inventor 
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Time Machine Radio 


We've seen many a retro radio project, but this one Is Gg personal dip 
into the past. Nicola King enjoys ag melodic journey through time 


W hen New South Wales resident George the speakers, one of the potentiometers, and the 


Edwards wanted to make a Christmas lithium battery. 

present for his dad, he had the perfect A Raspberry Pi Zero 2 W equipped with a Pimoroni 
idea. As his father owned a beautiful 1938 Austin Audio Amp SHIM (with built-in DAC) provides 
car that he often exhibited at classic car events, analogue audio out to the speakers. “The finished 


George thought that making himavintageradioto — project has two working potentiometer knobs, one 
eo with it, that played the songs from bygone eras for the volume and one for ‘tuning’ the decade,” 








to add a little authenticity, would be a great gift. says George. “They’re both connected to a MCP3008 
bet it “T had thought a little music box which played [ADC] and then [Raspberry] Pi.” An Adafruit 
Edwards content from the 1930s and 1940s would be an PowerBoost 1000C acts as both a charger for the 
Scceeia excellent addition to the car when it’s on display,” lithium battery and a power supply for Raspberry Pi. 
computer science explains George. “After putting some thought into Regarding the software, Raspberry Pi boots up 
graduate and a making one myself, the idea of having content to a Python script which is infinitely looping. “At 
hea ee 4 from each decade in the 20th century somehow each loop it does three things: changes the channel 
that any computer- seemed more naturally appropriate.” if someone has ‘tuned’ to a different decade; plays 
based tech the next song if it’s appropriate to do so; and then 
actually works! Radio refit sleeps for 50 milliseconds so we don’t smash the 
magpi.cc/ So, George set to work on a project that would CPU. Rinse and repeat ad infinitum.” 
alephzero take him around four months. For the hardware, To ensure that each tune gets a fair chance of 

he gutted a vintage-look NR-3013 radio bought being played, George has worked it so that once 

from Amazon, salvaging a few components like a song is selected, it is moved from an ‘unheard’ 


array to a ‘heard’ array, “effectively removing it 
™ from the pool of songs to be plucked from. Once all 
songs have been heard, they get moved back and 
the process starts again.” 





Doctor Who? 

Whenever the dial is turned to move between 
decades, the sound of Doctor Who’s TARDIS is 
heard. “We used to watch Doctor Who together 
when | was a kid, and so using the TARDIS sound 
to ‘move through time’ to another decade seemed 
appropriate,” says George. 

Another lovely touch is the inclusion of a “secret 
decade” within the radio’s setup, which contains 
some personal content that George’s uncle had 
digitised from old tapes. “They’re recordings of my 
A George replaced the controller board (shown here) from the radio's back late grandfather who died when ae father was a 

panel with a Raspberry Pi Zero 2 W, but kept the lithium battery and speaker young Man and whom I’ve never met,” he explains. 
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The vintage look 

Km e)genile (sxe Monaala 
NR-3013 FM radio, 

1a ce)aaMvdal(evamel-re) ae [= 
salvaged several parts 


Mm Anyone with either an 
Interest or rudimentary 
Understanding of electrical 
engineering and/or 
microelectronics could 
make one 


He did the same for another version of the 

radio that he made for his father-in-law, as he 
managed to include some audio of his late father 
too in that radio’s hidden decade. 





A An Audio Amp SHIM is used to output analogue 
audio to the original radio speaker 
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George printed a custom face 
folt\K-m co) mtal-mcelallaveme|t-lemaclgamimne) 
time-travel between decades and 
latsy- are tssseleat=1k=1e Bcve) ale iom-lale xe) el ale ts 


OJal=Meo) mi dal- Me) sal=)mi daleleys) 
UiY-v-mdal-melalellat-lmestelle 
feXe)K=Jalde)aavsi k= lane) 

ro l[Uls]maal-mvcellelaal=) 





George thinks making a time-travelling retro 
radio is within the grasp of many. “Anyone with 
either an interest or rudimentary understanding 
of electrical engineering and/or microelectronics 
could make one,” he urges. “Provided you’ve 
got Googlefoo you should be right, and I would 
encourage all who are interested to give ita 
crack. Anyone reading this can get in touch at 
georgeedwardsmail@gmail.com, and I’|l be 
happy to answer any questions.” 

With that generous encouragement, have a go, 
personalise your decades as George has done, and 
enjoy a trip to yesteryear. 





Vv 


> You can find the 


open-source code 
for this project 

at magpi.cc/ 
tardisradio 


The tunes come 
from Australia’s 
National Film and 
Sound Archive 


> His Dad loves 


his gift, listening 
in his garage as 
he tinkers 


> George has since 


used a Raspberry 
Pi to also make a 
web-streaming 
baby monitor.. 


> .and he's 


generously 
shared the code 
here: magpi.cc/ 
babycamgh 


<4 George's father 


owns a beautiful 
Austin classic Car, 
so he thought 

the TARDIS Radio 
would complement 
it perfectly 
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Making microscopes accessible and affordable by 
Open-sourcing it. Rob Zwetsloot takes a peek 


t’s not too hard to understand that Raspberry 

Pi cameras can be used for microscope builds 

— you just need the right lenses to focus the 
image on a small enough object. With a bit of 
custom code and software paired with it, you can 
then use it to view a tiny, hidden world. 

“We have developed M4All, a fully open-source, 

3D-printable, and modular microscopy system, 
which enables wider accessibility to advanced 





Gemma Cairns 


=) A NanoBioPhotonics 
® PhD student at 
the University 
of Strathclyde, 
developing imaging 
technologies. 


y Another diatom 
shot, with another 
amazing pattern 
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imaging techniques at a much lower price point 
than commercial microscopes,” Gemma Cairns, 
one of the students working on this project, tells 
us. “We integrate Raspberry Pi components into 
our M4All systems for microscope control, image 
capture, and data analysis.” 

The team, the NanoBioPhotonics group at the 
University of Strathclyde, have been using their 
imaging expertise to “investigate the mechanisms 





This is actin, a protein that forms the cytoskeleton of cells, illuminated with fluorescence 


that macrophages (a type of immune cell in the 
body) employ to remove respiratory pathogens”, 
pathogens that, among other things, can lead to 
pneumonia or meningitis. 

“From my experience using research microscope 
facilities to image macrophage samples, I realised 
there can be limitations with accessing commercial 
microscope systems, not only with costs but also 
time limits and flexibility,” Gemma explains. 

“A high-end research microscope can cost over 
£250,000 and so access to it can be limited and 
charged per-hour! In the past few years there has 
been a growing community of research groups 
working on open-source microscopy hardware and 
software solutions. Seeing their work inspired us to 


MWe wanted to create 
gq system that can be 
used by a wide level 
of expertise @ 


create M4All, which directly addresses our imaging 
requirements for macrophage research, but also 
contributes to the community where the system 
can be adapted for many other applications.” 


Raspberry Pi microscope 

The team opted for Raspberry Pi because they 
wanted something low-cost and small, and 
Raspberry Pi’s Camera Modules and HQ Cameras, 
along with its GPIO pins for controlling motors and 





A This is a diatom, a single cell of algae which has 
silica cell walls which create an amazing pattern 
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A selection of lenses 
and filters are used 
so Raspberry Pi 
cameras can see 
laalioageysyexe) 0) (omex=) Ik 


An RGB laser is used to 
WtUTaallatcixsmaatsmelbinslaslale 
dyes in the samples 


Raspberry Pi is able to 
receive the images and 
SW =) ae (oesYo)aal=m eley=i ne 
fe)gerex=s-s-] ale Re)amtal=lan 


LEDs, made it perfect as the heart of M4All. The 
next step was just making it all fit together. 

“Developing the designs for the 3D-printed 
parts has been a very iterative process to achieve 
their final form,” Gemma says. “We wanted to 
create a system that can be used by a wide level of 
expertise, but also has the stability and capability 
for quantitative biological imaging (that is, images 
where the brightness of each pixel can be trusted 
and compared with nearby pixels or other regions 
of the image to perform numerical analysis). The 
modular cubes are printed as monolithic parts to 
form the optical path, and the inserts are designed 
to minimise the number of degrees of freedom for 
alignment. The only optical alignment that needs 
to be carried out is setting up and focusing the 
lenses for imaging.” 





Vv 


Vv 


M4AIl uses 
fluorescence 
microscopy 

that involves 
fluorescent dyes... 


Which are 
illuminated by 
different light and 
then filtered 


The next stage is 
testing live cell 
imaging in a cell 
culture incubator 


OpenFlexure was 
created by the 
University of Bath 


The ultimate aim 
is to see real- 
time interactions 
with bacteria and 
other cells 
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A There's also a more 


traditional ‘bright-field we wa a ° 4 Zs -& ‘+ a» - ww ® a ~ % %, 


microscope method, 
with a light and lenses 
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01 You can choose between two different 
methods of microscopy - bright-field or 
fluorescence. You'll need to prepare your setup 
Slightly differently for each style, although both use 
a similar series of stepper motors and Lenses. 





As an open-source project, it also integrates 4 To get the right focus and 
Kf ‘ ‘ filtering, there are a lot of 
other open-source bits into it, like OpenFlexure. te ceneolled Iancee 
OpenFlexure allows the image to be separated ina to manipulate 
specific way and focused on the camera installed in 
Raspberry Pi. 


Small goals 

“We have been able to image various structures 
inside of cells using fluorescence microscopy, such 
as mitochondria, bacteria, and actin, with good 
resolution and with a signal-to-noise ratio which 


allows us to obtain quantitative information on 
02 For fluorescent microscopy, you'll need to add 


what's happening in the cell,” Gemma reveals. fluorescent dye to the sample. This will react 
“This will allow us to study interactions with to different wavelengths of light. 


bacteria inside of macrophages at a much lower 
cost than commercial systems. Then, if interesting 
data arises, more specialised microscopy systems 
can be used for further analysis based on what 

the M4All microscopes have found. We have also 
imaged diatoms in bright-field which are single 
cells of algae. Their cell walls are made of silica, 
which forms very intricate and cool patterns.” 

You can head to magpi.cc/m4all for instructions 
on how to build your own system, and start doing 
your own microbiology. 

“Having a flexible platform also means that 
we can test out new designs and applications 
in collaboration with a huge range of 
researchers — from biochemists or marine 
environmental scientists!” Hl 





You can then observe and analyse your results 
03 ae. 
via Raspberry Pi as it captures and processes 
the image. 
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Retro barcode scanner 


Forget plug-and-play! Neil Thomas and Chris Harris have created a scan-and-play 
system gs part of dg replica retro video game shop, as David Crookes explains 





Neil Thomas 





Neil is a retro tech 
YouTuber who has 
been running his 
channel as his full- 
time job since 2019. 
His first computer 
was an Amstrad 
CPC464! 


magpi.cc/ 
rmccave 


> Games are loaded 
using a barcode 
reader powered by 
Raspberry Pi, called 
Barcode Rattler 
(magpi.cc/bcrattler) 


indulged his passion for classic technology 

by presenting a popular YouTube channel 
called RMC - The Cave. Tens of thousands of 
viewers watch him bringing the past back to 
life (literally, in some cases, by repairing old 
machines). But success ended up creating a small 
problem for Neil: what to do with all of the retro 
consoles and computers he’s ended up collecting. 

“Tt felt a shame to go to so much effort in 

restoring and repairing these classic machines 
only to hide them away in a cupboard,” he says. 
“A pipe dream began to form that I might one day 
be able to open an exhibition space for retro fans 
to come and enjoy them and, through hard work 


c or the past five years, Neil Thomas has 
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and incredible generosity from viewers, here we 
are, on the cusp of opening up to the public.” 


Hey MiSTer 

Located on the top floor of an 18th century mill 

in Chalford in Gloucestershire, The Cave, as the 
space is called, includes lots of games consoles and 
computers from the past 40 years, as well as classic 
arcade machines. But one of the stand-out sections 
is areplica retro video game store where visitors 
can pick a game off a shelf, scan its barcode at a 
kiosk, and quickly start playing — a system that has 
a Raspberry Pi 3 computer at its heart. 

“We’d just created new hardware called the 
MiSTer Multisystem which was powering the kiosk 
in the shop, but choosing a game to play on it 
required me to open the kiosk and manually select 
one, and that meant there would really only be 
one playable game all day,” Neil recalls. “I wanted 
to make it more fun with a front-end menu that 
wouldn’t confuse visitors, and then realised the 
room itself would make the perfect physical front- 
end. It didn’t need to be a menu on the screen!” 

At first, Neil and his friend Chris Harris 
considered using a Raspberry Pi Camera Module 
to scan the barcodes. “But we found that 
environmental changes in light and mounting 
it behind the smoked perspex of the kiosk made 
it less than 100% reliable,” Neil says. “We then 
switched to a handheld barcode scanner which not 
only works great but also fits the theme of a retro 
shop very well.” 


Space invader 

Raspberry Pi runs a program called Barcode 
Rattler, created by Chris. It processes information 
from the scanner connected to Raspberry Pi via 
the USB port, and the information is sent via a 
secure network connection to the MiSTer gaming 


, 


The MiSTer Multisystem is, 
like Raspberry Pi, tucked 
re Wife Walalsi(e (== meiel eleley=| ge 


A Raspberry Pi is powered 
ii ce) aa tal= Ops) = ole)a me) maal=) 
MiSTer Multisystem 


Bi atom cy-lcerole(-e-rer-lalaliale 
system is managed 
by Raspberry Pi 





device — a highly accurate system well-loved by 
retro fans that emulates machines using an FPGA 
chip rather than software. 

“Python waits for a keyboard event which it 
then reads and looks up a barcode in a CSV file,” 
Neil explains. “The barcode scanner behaves as a 
keyboard device so, when it scans a code, it sends 


™ People seem to enjoy 
Zapping the games and 
they love the ‘beep' of the 
Darcode gun @ 


the string to Raspberry Pi as if you’d typed out the 

numbers on the keyboard. If it finds a matching 

barcode in the CSV, it will send SSH commands to 

the MiSTer to start the correct system core and load 

the game via a utility called MiSTer Batch Control.” 
The result is a fun physical user interface that 

has gone down well with those who have tested it. 


A Visitors can just take a 
game from the shelf and 
scan at this kiosk which is 
inside a replica retro video 
game shop 


“People seem to enjoy zapping the games and they 
love the ‘beep’ of the barcode gun,” Neil says. It’s 
also become his favourite room. “It’s a time-warp 
where you can forget the real world for a day and 

be swept away in a wave of carefree nostalgia,” he 
adds. “What could be more nostalgic than revisiting 
the video game shop from your childhoode” 
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> The games play on 


a CRT monitor 


> One button 
turns the whole 
system on 


>» Adatabase of 
barcode data 
was created 


> The games play 
via a MiSTer 
Multisystem 


> ROM sizes limit 
games to 8- and 
16-bit titles 


The MiSTer 
Multisystem was 
created by Neil in 
collaboration with 
the electronics firm 
Heber, and allows for 
accurate hardware- 
based emulation 
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Elevated 





Materials 


Fine process control for spgce-grade 
waste recycling, By Rosie Hattersley 


T 


he idea that grew into Elevated Materials 
(elevatedmaterials.com) came about when 
founder Ryan Olliges — then seconded to 


the Rocket Propulsion Lab at the University of 
Southern California — was tasked with sourcing 
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carbon fibre offcuts that he and fellow students 
could use for their designs. He soon found he 

had more waste material from the space and 
aeronautical industries than the lab could use, and 
his first business used a heat press to repurpose 
the material to produce extremely robust, 
streamlined, lightweight skateboards. 

The project was a commercial success and, 
having proven the possibilities of secondary-use 
carbon fibre, Olliges and colleagues set up Elevated 
Materials to address in earnest the need fora 
responsible alternative to landfill for this industrial 
by-product. They ramped up their recycling 
efforts, bringing in the technology needed for 
precise control of the finely tuned heat treatment 
that is required to repurpose each consignment. 


THE CHALLENGE 


Most of Elevated Materials’ commissions involve 
waste produced during the manufacture of rockets 
and spacecraft, high-tech vehicles that really 
need the strength-to-weight ratio that carbon 
fibre offers, explains Jaysen Harris, the company’s 
co-founder and Tech Development VP. These 
waste materials come from the manufacturer 
with bonding resin already introduced into the 
carbon fibre weave. Bonding together in multiple 
layers and orientations is what gives carbon fibre 
products their strength, but the composition of 
each product that Elevated Materials receives 
from each client is different. Consequently, each 
consignment needs a different heat treatment to 
process it for reuse. 


Importantly, the design patterns embodied in 
the waste carbon fibre is destroyed in treatment. 
This is critical to preventing its composition 
from being reverse-engineered: a key part of the 
service Elevated Materials provides is to make 
sure nothing persists that could potentially let a 
client’s competitor know the temperatures, resin 
amounts, and composition used. 

Sophisticated temperature control and detailed 
logging are essential. 


M Raspberry Pi provides 
detailed report logging so 
processes can be analysed 
Gnd replicated 


THE SOLUTION 


Elevated Materials uses a heat press and 
technology developed in-house together with 
Raspberry Pi 3B+ as the process-controlling 
computer to bring in multiple temperature and 
pressure values, ensuring they are adhering to 
the manufacturers’ specifications of the material, 
with exactly how much heat to apply and how 
quickly to increase it. 

Raspberry Pi provides detailed report logging 
SO processes can be analysed and replicated. Later 
in the recycling process, some of the treated and 
pressed material is precision-cut into smaller 
sizes and custom parts with a Raspberry Pi- 
controlled file server and connected CNC router. 


WHY RASPBERRY PI? 

Tech Development VP Jaysen Harris credits 

the precision afforded by Raspberry Pias a 

defining feature of Elevated Materials’ offering. 

“Raspberry Pi is constantly taking values and 

evaluating where it’s supposed to be, making any 

changes and turning on and off the power.” 
Other available solutions were inferior: “There 

are products out there that do temperature 

control, but we would not have gotten such 

an easy-to-use, thorough logging capability.” 
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Alternatives would also have been more expensive 
and, given the level of sophistication required, 

“it would have been inaccessible at that level of 
startup,” he says. “We just wouldn’t have been 
able to do it.” 


THE RESULTS 


Elevated Materials is the only company in 
southern California offering a carbon fibre 
upcycling service; the minute control offered by 
the Raspberry Pi controller at the heart of each 
of its heat presses allows it to offer more services 
than competitors as well as greater precision — 
assets that win them more customers. 

Innovation, key to the company’s success 
so far, is something Raspberry Pi’s broad 
product range continues to support. Harris 
is investigating further use of Raspberry Pi 
computers, particularly the Compute Module 
line, which he envisages as the brain of their heat 
presses. Meanwhile, Raspberry Pi 4 offers upgrade 
possibilities for CNC routers, and Raspberry 
Pi Camera Modules could provide valuable 
monitoring. Raspberry Pi digital signage is used to 
explain the process to visitors. “We are constantly 
iterating,” Harris says. 

To date, Elevated Materials has kept more than 
200,000 lb (approx 90,000 kg) of carbon fibre out 
of landfill. Zl 
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JOIN FOR 12 MONTHS AND GETA 


WITH YOUR FIRST 
12-MONTH SUBSCRIPTION 


A full Raspberry 
Pi desktop 
computer 


Learn to code and 
build your own 
projects 


Make your own 
retro games 

console, media 
player, magic > 
mirror and much, | ig, This is a limited 


offer. Not included 


much more = S ~ on with renewals. Offer 
ee subject to change or 
withdrawal at any time. 
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HIDDEN 
HACKS 


FUR RASPBERRY PI 


Cfalaaale)d=micelaamyelelmanqgelaelanelelesmiien 
these clever tricks By Lucy Hattersley 
computer that delivers much more 


R power and functionality than its small 
stature suggests. Now, with ten years of solid 
development behind it, Raspberry Pi computers 
and Raspberry Pi OS are packed with activity. 

Hidden in amongst all the hardware and 
software are some real gems of tricks that you can 
use to learn more about computing, make better 
projects, and get far more out of Raspberry Pi than 
you ever thought possible. 

In this feature, we’re going to unearth hidden 
hacks and handy tricks that every talented 
Raspberry Pi owner should know. 


aspberry Pi is an incredibly versatile 
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pidraspherrypi46ea: 
Adding use lucy’ 


Is fi nformat 7 
pibraspberrypi1466: 
ni pi 
Pibraspberrypi4ee: 


Set up a new user 


As a security measure, you should set up a custom user name, rather 
than using the default ‘pi’ user that has been used in Raspberry Pi OS (and 
previously Raspbian) since the beginning. 

Get on board with improved security and create your own new 
user account. 


Create new users in Raspberry Pi OS with adduser and the desired 
username (in this example, ‘izzy’): 


sudo adduser izzy 


You will be prompted for a password for the new user, izzy. Enter a 
password for security reasons. Terminal will ask for the Full Name, Room 
Number, Work Phone, Home Phone, and Other information. Press RETURN 
to keep these blank and enter ‘y’ to ‘Is the information correct?’ 

When you create a new user, they will have a home folder in /home/. 
Upon creating a new user, the contents of /etc/skel/ will be copied 
to the new user's home folder. You can add or modify dot-files such as 
the .bashrc in /etc/skel/ to your requirements, and this version will be 
applied to new users. 
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ee 


Overlay File System keeps Raspberry Pi OS ina 
fresh state. With Overlay File System enabled, any 
changes you make are saved to RAM instead of 
storage, and are lost when you reboot. 

This is useful for using Raspberry Pi in a public 
setting where you want people to be able to 
use the operating system without making any 
permanent changes to it. Such as with a Raspberry 
IP See Ue) lint al Sone. 

Open Raspberry Pi Configuration and choose the 
Performance tab. Click Configure next to Overlay 
File System and enable User Overlay. 

The write-protect boot partition enables 
you to lock down the boot partition for even 
more security. 


CC 


‘Take a look at the kernel! 


Raspberry Pi kernel is stored in GitHub 
(github.com/raspberrypi/linux). It follows 
behind the main Linux Kernel. Raspberry Pi 
takes long-term releases of the kernel, which 
is mentioned on GitHub, and integrates 

the changes into Raspberry Pi kernel. 
There is also a ‘next’ branch that 

(ole) al e-Nbekcr-belebelsin-10)(<mole)ameymmal= 

kernel. After extensive testing 

and discussion, the next 

branch becomes the 

main branch. 


Switch users. 


The Bj command (related to Rifle, which we’1l 
look at later) is used to ‘switch user’. 


Su 1zzy 


...will switch between your current user and 
IAAT, \ sie to see which user you’re 
currently using. 





whoami 





...will return ‘izzy’. You’1l be in the pi folder still 
So use {| to switch to izzy’s folder. 


cd /home/izzy 


Use MB and you’ll see the files created by 
/etc/skel. 


-Sudoers list | 


The default user on Raspberry Pi OS is a 
member of the sudo group, which enables it to 
perform elevated actions (as root) when you 
yomaela (elo) anbant-belen 

To add your new user to the sudo group, use: 


Sudo adduser izzy sudo 


Now they’1l also be able to use Eifel. 





pifraspbherrypi4o8:= § 
Hit:1 http://deb.deb 


Hiti2 https /archive.. Hf FYPL.orgedebian 6 


packages can be 1 l 
pifraspherrypaibe:= & sudo ap 
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Operating System 


Raspberry Pi OS (64-bit) 


ih the Raspoernry Pi Dezkiep (Compettte 


ho ces eho n ery 





If you’ve been running Raspberry Pi OS for a while, the chances are you’ re 
using the 32-bit version. It’s time to double-up to the latest, 64-bit 

edition. This came out of early beta testing last month, and can now be 
found inside Raspberry Pi Imager (magpi.cc/imager). If you have a Zero 2 W, 
Raspberry Pi 3, Raspberry Pi 4, or Raspberry Pi 400, then make the switch 

to Raspberry Pi OS (64-bit). Read Gordon Hollingworth’s blog for a detailed 
write-up (magpi.cc/64bit). 


: “Chances are you're 
_using the 32-bit version 
of Raspberry Pi OS” 


TIP! 


Check out 
sources 


APT keeps a list of 
software sources 
oo kespberry Piin |B RSRESRESRR Storm cnnnonnsonnenncnsnnnnncncnnnncnnnnnnc is 
a file at /etc/apt/ 


nn Updating Raspberry Pi 





It’s best to update Raspberry Pi OS using the 
built-in Software Updater tool. You should do this 
frequently. It’s important to keep Raspberry Pi 
OS up-to-date for security purposes, and also to 
ensure you are running the latest version, which 
will contain fewer bugs. 

It is also possible to update Raspberry Pi OS 
using APT (Advanced Packaging Tool) in Terminal, 
but make sure to do a full upgrade (rather than just 
a regular upgrade). 


sudo apt update 
sudo apt full-upgrade 


Oksteted Ful - upgrade @wompemcaulerupgrade) 


ensures that APT picks up any dependency changes 
that have been made. 
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TAKE CONTROL 


OF YOUR RASPBERRY PI 


Take control of your Raspberry Pi 
from across dg network 


Copy files with SCP | a 


After you have connected to Raspberry via SSH 
(or VNC), you’ ll soon wonder how to copy files 
to and from a remote computer on the network. nies 7 ceaeahiat 
There are a few different ways to copy files,and : oO neg ae 
we generally prefer to use SCP (secure copy). 
While in Terminal on your source computer, 
you use the command with the SSH login ‘i Authentication 
details and file location (separated by a colon). It mC pasreord Change 


Connectivity Security 


nm uhrald cheek Gar 
er Ler 


Calc hyphae 
tice) pt 


looks like this: 


scp <user@IP>:path/to/file path/to/ : 4g . 
: : : = 
destination 





Let’s say we want to copy a file called test.txt : : 
from the Desktop on our Raspberry Pi to ae Rem ote CO ale ge A VN C 


the Desktop on our remote computer; we 








would enter: - VNC enables you to remotely access Raspberry Pi from another computer. 
VNC is a graphical desktop system that lets you view the desktop of 
scp pi@192.168.@.40:/home/lucy/Desktop/ Raspberry Pi OS from a window in another computer. 
test.txt /home/lucy/ To do this, you’1l need to activate server software in Raspberry Pi OS and 
install viewer software on your other computer (this can be a Mac, PC, or 
We find it less wordy to navigate to the Linux computer, or another Raspberry Pi). 
destination folder on our computer, andthenuse_ : Raspberry Pi OS comes with VNC Server built in. All you need to do is turn 
a dot ‘.’ as the destination to copy the filetothe : it on. Open Raspberry Pi Configuration (menu > Preferences > Raspberry Pi 
current location Configuration) and choose Interfaces. Set VNC to On and click OK. 
The VNC Server icon will appear in the menu bar. Click it to open the VNC 
cd ~/Desktop Server window, and you will see the IP address underneath. 
scp pi@192.168.0.40:/home/lucy/Desktop/ : You will most likely need to install VNC Viewer on the other computer 
GeStstxt - (magpi.cc/vncviewer). Once installed, open the IP address of your Raspberry 
Pi into the text bar of VNC Viewer and press RETURN. Enter the Username 
If you copy a lot of files, you can install FTP : and Password for Raspberry Pi OS and click OK. 
(File Transfer Protocol software) like FileZilla You will now be able to remotely access Raspberry Pi OS desktop in 
(filezilla-project.org) and use it to transfer files : awindowon your remote computer. Take a look at magpi.cc/vnc for 
across computers on your network. : more information. 
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a Raspberry Pi OS for the change to take effect. 
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Remote control: SSH - 


SSH (Secure Shell) is the simplest way to access a 
Raspberry Pi on your network. The downside is 
that it works via the Terminal and is command- 
ine Ceiseal, WOU Hee Wo acnhelws SSis| Cal yfebbe 
Raspberry Pi first. Launch Raspberry Pi 
Configuration from the Preferences menu and 
CMO NS Winasiniayees,, Sele ‘clare teevalife) love here) e) over.qe we 
Solte Einabledamnd click Ok: 

You’ ll need the IP (Internet Protocol) address 
for your Raspberry Pi, which you can see by 
hovering your mouse over the network icon in the 
menu bar. It will be a sequence of four numbers 
separated by dots. Ours is: ‘192.168.0.40’ and 


: Set Headless Resolution : 3 the username of Raspberry Pi, which on our 


computer is ‘pi’. 





When accessing Raspberry Pi OS remotely, without a monitor attached, Open a Terminal app on a macOS or Linux 
you will find the desktop defaults to a tiny 640480 resolution. There is : system, or PowerShell on a recent edition of 
an easy way to fix this. Open Raspberry Pi Configuration and click Display. Windows. Many Windows users use a Terminal 
Set Headless Resolution to a higher setting (it will need to be compatible : app called PuTTY (putty.org). 


oe To connect, you need to enter 


Click OK and you oe a Kuser>@<ip address >Maem-rcrenelics 


will be prompted ee 2 , 

forestatyor . “Your Raspberry Pi computer's guesses 
Raspberry Pi. : i 

ven it en : alekadaleraal= IS well VVelaga 3 You will be prompted for that 


you’llbeusing the : . > username’s password of the remote 
new resolution. Gg eTTIN Gg to kn ow’ : computer (the Raspberry Pi you are 
; > connecting to). Enter it and respond 
with ‘yes’ to the security prompt. You 
will only see this prompt the first time 
J SEBO  SRee ee you attempt to log in. You will now be signed in to 


: : our Raspberry Pi. 
Set a custom hostname | ie ld 


° 
eooeeeeeesee eee eee eee eee ee dUdUdUdUdUdUdmUmmUmlUlUlU lh Ml OO te ee oe mee eee eee eee eee eee ee eee esse ese eeseeeseeeesee eee eee e eee eee eee eee eee eee & 


Your Raspberry Pi computer’s hostname is well 
worth getting to know. The hostname is a label that 
can be used to identify and locate your Raspberry 

Pi on a network. By default, all Raspberry Pi 
computers have the hostname ‘raspberrypi’. You 
can connect to a Raspberry Pi using the hostname 
and a‘. local’ suffix instead of the IP address. 


ssh pi@raspberrypi.local 


If you have more than one Raspberry Pi, it’s 
a good idea to start renaming them. Open the 
Raspberry Pi Configuration tool under Raspberry 
Pi menu > Preferences and choose the System 
tab. Change the text field in ‘Hostname’ to your 
custom name and click OK. You will need to restart 
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GET HEADLESS 





WITH RASPBERRY PI Uo 


Desktop? Where we're going we don't need desktops 
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hen you first set up Raspberry Pi, you 
AY generally connect a screen, keyboard, 

and mouse and navigate Raspberry Pi OS 
using the graphical user interface. 

This isn’t the only way to use Raspberry Pi 
though, and you can install Raspberry Pi OS Lite 
(64-bit). This is a port of Raspberry Pi OS with no 
desktop environment — everything takes place 
in the Terminal. 

There are a lot of advantages to running 
Raspberry Pi OS in headless mode. Especially if 
your project is going to be used remotely, without 
a screen attached (say, as a weather monitor or 
security camera). Once these projects are set up, 
you’ ll only access them remotely via SSH, so it 
makes sense to set them up as light as possible. 
The download is only 0.4GB, so it fits on smaller 
microSD cards. 

Thanks to a recent update in Imager, it’s much 
easier to add custom settings to Raspberry Pi OS 
during the installation procedure. You can now add 
custom hostname and wireless LAN settings, as 
well as activate SSH for remote access. This makes 
it possible to fully set up a headless Raspberry 
Pi without ever having to attach a keyboard 
and monitor. 


Hidden Hacks for Raspberry Pi 


Use Imager to set up a headless 
Raspberry Pi 


Taksvee]|mianielel=te 

Imager is an app for Windows, macOS, and 
Linux that makes it easy to set up Raspberry Pi OS 
and other operating systems. View installation 
instructions at magpi.cc/imager. Open Imager and 
attach a microSD card to your computer. 

Click on Choose OS and select Raspberry Pi OS 
(other) and Raspberry Pi OS Lite (64-bit) if you are 
using a Raspberry Pi3, 4, 400 or Zero 2 W; or 32-bit 
if you are using an earlier computer. 





Ce 


Set the hostname 

Choose Storage and select your microSD card 
(we’re using a 4GB microSD card as we don’t need 
the full 8GB required by the full desktop OS). Before 
Starting the process, click on the Advanced Options 
cog in the bottom-right. Here you can set up a range 
of options for the install, which will be very helpful 
when running headless mode. Start with ticking 
‘Set hostname’, and change it to something unique 
on your network; we’re changing from the default 
‘Taspberrypl to ‘zero2’. 
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Ofe) ay al=lean dela dal=mar=aanie) ac 
Check the ‘Set username and password’ 


and enter a password. Now check ‘Configure wifi’ : : “There Giglme lot of ofe\Zelahaels [ats 


and enter your SSID (wireless network name) 


and wireless LAN password. Finally, set the : jcemaciala l Nn g Tas Dp be Ty ey OS | a 


locale settings to your location. Click Save when 
at 2 headless mode” 

Click Vulte amd Yestorecordthe Raspberry Pi; 
OS Lite operating system to the microSD card. : 
And Yes again to the warning and enter your RETR eee fl 
password if required. : 


ote eee eee eee eee eee sees ee eee eee eee ee eee eee, 


sch pata liegeeph ean tata Re : Decode the LEDs , 


Connect via SSH : Raspberry Pi boards have a red power light and a green status light. If 
Wait till it’s finished and transfer the Raspberry Pi fails to boot or has to shut down, the LED will flash a specific 
microSD card to your Raspberry Pi. Now boot : number of times to represent the situation. Use this table to decode 
up and Raspberry Pi will connect to your local : the LEDs. 
wireless network. And you can connect to it via 








SSH from Terminal on another computer. Wait Long flashes Short flashes Status 
for Raspberry Pi to boot and use the custom : 
hostname (that you set up in Imager) to connect : 0 2 Generic failure to boot 
(re) ie, VeOua) (eelinl We yeral 22 ave Ihe eleleliness Ukshorek 
@) 4 start*.elf not found 
ping zero2.local 
@) 7 Kernel image not found 
And connect to the computer using SSH and 
the hostname: e) 8 SDRAM failure 
Or via the IP address (substituting the numbers: @) a6) In HALT state 
for Raspberry Pi on your network): 
2 1 =zbamhacoyemelelma-Wn 


ssh pi@192.168.0.22 


WS) 
WS) 


Failed to read from partition 


From here on in, you can access your Raspberry: 7 
Pi via SSH on another computer. This setup is 5 2 3 Extended partition not FAT 
ideal for Raspberry Pi projects that don’t use a 


keyboard and screen, and which embed Raspberry 2 4 File signature/hash mismatch ~ Pi 4 
Pi in a mobile or hard-to-reach location, such as 
a robot or security camera. 3 1 SPI EEPROM error ~ Pi 4 
— 3 2 SPI EEPROM is write protected - Pi 4 
. 3 3 I2C error - Pi4 
a = 4 4 Unsupported board type 
.; —— 
2 4 5 Fatal firmware error 
4 6 Power failure type A 
vA 7 Power failure type B 
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NEXT-LEVEL 


TERMINAL 


The joy of text with Raspberry Pi's 
@elanlanelalem ialomiaitsaielas 





ot tee eee eee eee eee eee ee ee ee © 6 © 8 8 8 8 8 8 mg Oe rm we ee eee eee esses ee , 


- Switch to root - Config txt 


An elevated & command on its own switches to the root user. Enter: : The config.txt file is read by the GPU before the 
ARM CPU and Raspberry Pi OS Linux is initialised. 
: It is located on the first (boot) partition of the 
: microSD card alongside the bootcode.bin and 
...toruna Shell as the root user. Every command you enter will be as a start.elf files. 
superuser, so you do not need to use sudo or enter a password. This can be qt ifs possible to view the values of cOnEE. txt 
helpful with complex installations that require multiple sudo privileges. -onfig 
It’s a bad habit though, and you should only use sudo su when required and 








exit from the root shell as soon as possible (enter Bama). 
You can learn more about sudo in Raspberry Pi’s documentation 
(magpi.cc/sudo). 


vcgencmd get_config arm_freq 


...will return the CPU frequency set in config.txt. 
You can also use bigja and kidg to see all values 











stored as integers and strings. 





vcgencmd get_config int 
vcgencmd get_config str 


You can edit config.txt using: 


sudo nano /boot/config.txt 


It is also one of the files you can edit manually 
by removing the microSD card from Raspberry 
Pi and attaching it to another computer (macOS, 
Windows, or Linux). 

Any changes you make to config.txt will only 
take place after you reboot Raspberry Pi. 

Take a look at the official Raspberry Pi 
eLolerbnentcsonncimloyem@rit-t:40) MeerKeoy shi l:4m-¢m@ mNOReDICO\UcyE 
more about the settings in config.txt. 
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J 





Raspberry Pi 400 Rev 1.0 


- : Go back in time | 


2 Display Options Configure display settings 
Interface Optians Configure connections to peripherals ; c : 
Performance Options Configure performance settings ~ y ibimrsolel want to ex) imavemelmaleya way, you can las tall 
Localisation Options Configure language and regional settings : 2 

6 Advanced Options Configure advanced settings , earlier Sines: 

8 Update Update this tool to the latest version 

§ Abowt raspi-config Information about this configuration foal 





sudo apt install tcsh 
sudo apt install csh 


<Finish> 


Then open into them with or fae. They 
are a lot more limited compared with the default 
Bash shell, and csh (C Shell) doesn’t have tab 
autocomplete or history. Use to back out and 
back to your default shell. 





: Raspi-config is your friend rr 2 sviolalsacn ao ADSs AIRE ci EU Ao AP OE OR a 
When Raspberry Pi first came out, raspi-config was : mw Malelats|= your el-yaelelne 


used widely to adjust settings without diving into the 


uae sm hyabotemecoyenatcatnncin (oye al (cme N eli cMel-be(enmnele) Mer-leller= : S h a) | fro an B as h to 7S h " 


accessed from Terminal with: 


ares raspi-config Seater erat aMate rec tan aren sar enecstae atau co abawata gu gtcucucug renal ges taweulew seam eu eMaMs 


These days it’s easier to use Raspberry Pi Configuration (under menu > 
Preferences) when in the desktop interface. But if you’re using Terminal, 


ott eeeeeereerese eee eeseeeee ee ee eee eee ee eee, 


headless, or accessing via SSH knowing raspi-config can be a game- : Ta b com @ | etion 3 
changer. See magpi.cc/raspiconfig for more info. 

Behind Raspberry Pi Configuration and raspi-config is a text file called : It’s a basic hack but if you don’t know 
config.txt. This sets many settings for Raspberry Pi OS. it, tab completion is a game-changer. 


: When using the Terminal, simply start 
3 $e dsoosd Oe USES ONSH SSE SOON TORO ee 1mrg 0) ba koar= mere) anh anY-b ele me) menbn rece) mia (olerlale)em-navel 
: press the TAB key to complete it. For example, to 
navigate to the Documents folder, open a Terminal 
window and enter: 


...and press TAB. Hey presto, it automatically fills 


chsh -s $(which zsh) up the rest. If there’s more than one location, it’1l 
show you the options and let you carry on entering 
You will be asked to enter your admin password. And changes only take : letters. Try: 


effect on restart: 


‘Change default shell 


You can change your default shell from Bash to Zsh (or earlier shells) using: 


cd D 





sudo reboot 





...And press TAB and you’ see ‘Desktop/ 


Open a Terminal window and you will be greeted with Z Shell. Documents/ Downloads’. Carry on 
: entering letters until you can autofill 
To get back to Bash, enter: Welomeceyenent-belebm Cole mer-Vemeliom ¥.Vs) 
: multiple times in each command 
name, directory paths, and 
...and reboot. > much more. 
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7. Al Viel Ske GH oe + Command aaa a are 
29 ALG Seer Lore cong 2 -neek epee sui fear en Leg 


‘Top and htop 


Top is an app used to display Linux processes, you can get it from the 
command line using: 


top 





The vcgencmd tool is a special terminal command 
designed for Raspberry Pi. It outputs information 
from the VideoCore GPU on Raspberry Pi and is 
especially handy for getting information on all 
aspects of hardware performance. 

Get a complete list of all the vcgencmd 
elo) anbenr-baXercmurssneley 


vcgencmd commands 


W Zo) bmerhambiciss 


vcgencmd measure_temp 


These return the current system temperature. 
And check how much RAM is in your Raspberry 
Pi with: 








vcgencmd get_config total_mem 





On the right is the COMMAND column, which has the name of the 
processes running. The PID is the process ID (the number of each process. 
The VIRT, CPU, and MEM columns tell you how much virtual memory, 
physical memory, and CPU usage for each process. Unlike most Terminal 
commands, top runs in an interactive mode with constantly refreshing 
windows. Press H to view keyboard commands, and ESC to return to the 
main window. 

Press Q to quit top and return to the command line. 

Htop is a more interactive, colourful version of top. Enter this at the 
command line: 


...And press Q to quit. 








sudo apt-get install htop 


Pressing H or F1 will bring 
pO oe Ie One, wee 
to take a look 
delcmastcbalerclem-belemaats 
htop.dev website has 
more information on 
how to use the program. 


TIP! 


Which shell? 


Wondering which shell you are using. There's a 


command for that: 


Pompe ooo 


See this StackExchange post for an explanation: 
magpi.cc/checkshell. 
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Measure the current screen resolution with: 





vcgencmd get_lcd_info 


Get more information on using vcgencmd 
in Raspberry Pi’s documentation pages 
(magpi.cc/vcgencmddoc). For the curious, take a 
look at the source code for the vcgencmd utility on 
GitHub (magpi.cc/vcgencmdgit). 


eqenchd measure Comp 


pifraspberrypi46e8:~— § vegencnd get_config total_mem 
total mem=4696 


pibraspbherrypi466: 





Four 


Using the Oh My Zsh template file and adding it to 


Do you want to change your default shell to zsh? [Yv'r 


Changing your shell to fusrfbin/‘zsh... 


Shell successfully changed to ‘/usr/ban/zsh’. 


MO a Be ae er Dee aa Ba 
f/ff fry, f 
i f 


Before you scream Oh My zsh! Look over the ~.; 


es, and options. 


+ Follow ws on Twitter: Bohmyzsh 
* Join our Discord COMMUNITY : Discord server 


* Get stickers, t-shirts, coffee mugs and more: Planet Argon Shop 


.oh-my-zsh git: (master) | 





Oh My Zsh 


Oh My Zsh (ohmyz.sh) is an extension to ZSH 
which enables you to take things even further, 
with a large number of alias shortcuts, themes, 
and plug-ins that enable 
you to add a huge range 
of functionality to the 
shell — everything 
from integrated web 
search to advanced 
GitHub functionality. 
Install Oh My Zsh 
using a script (also 
available on the website): 


sh -c "$(curl -fsSL https://raw.github.com/ 


ohmyzsh/ohmyzsh/master/tools/install.sh)" 





Take a look a the documentation if you 
want more information on Oh My Zsh 
(magpi.cc/omzwiki), and bookmark the 
cheatsheet (magpi.cc/omzcheatsheet). There 
are some great features in Oh My Zsh: you 
can use 1, 2, 3, and so on to return to 
preview directories. Also, be sure to 
make use of Oh My Zsh’s extensive 
plug-ins (magpi.cc/zshplugins). 
These feature everything from 
web search integration to 
Hitchhiker’s Guide to the 
Galaxy quotes. 


c° file to select plugins, them 


A am aleksmemslelaaaneyi 
aalele(-lsamicieiaelasw 
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1 ~/.zshre. Backing up to /home/pi/.zshre.pre-ch-my-zsh 


Terminal uses Bash (Bourne 
Again Shell) by default, which 
provides many of the advanced 
features such as tab completion 
and brace expansion. However, 
it’s not the final word in shell 
technology and you can switch 
to the more recent Zsh (Z 
Shell). This is an expanded 
Bourne shell. ZSH has a bunch 
of modern features. 


sudo apt install zsh 


Then start Zsh with: 


ey ea 





The first time you run Zsh, 
you will be offered Z Shell 
configuration options. This 
sets up the ~/.zshrc file 
(Guakcmeceyebatciebe-tmloyemallcoy 
For the first time, 

Nicoms Korero) apbentasarel 
using option ‘2’, 
which populates the 
.zshrc file with recommended settings. Z Shell has 
a colourful interface and a number of useful features. 
For example, in Zsh you now get the new 
(elo) anbont-baXenmilseblelsmaeyenleyeeters and (@] so you can make a 
directory and enter it with a single command: 


take test 


...1S equivalent to: 


mkdir test 


cd test 





A new command joins {itey, and shows all locations of a file on 
Path. To get back from Zsh to your usual Bash shell, enter: 


exit 


...And you’ ll be back to Bash. Take a look at the Zsh website 
(zsh.sourceforge.io) for more information and documentation. 
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RASPBERRY PI HARUWARE 


HACKS 


Cialaiaale)eomiaelaemiele|asleleseis 
with these physical hints 


Portable power : | aa 


One of the easiest ways to take Raspberry Pi News 
portable is to use a mobile phone charging + All news 
bank. These sticks typically use a USB 
connection to hold power, and you can 


plug them into Raspberry Pi just like your Network install beta test: oe ee 

phone charger. your help required! - altenspry 
It’s a hack though — if you want a more | ee ee m ‘Legecy) 

secure solution, it’s possible to power . | NEXT POST 

Raspberry Pi computers using batteries os acc ach an Wy retro games inakie 

(both alkaline and lithium). Devices such DS en . = araiemary 


as this LiPo Battery HAT for Raspberry Pi “= SeRTAT EGET 
(magpi.cc/lipobatteryhat) combine a power reer fem. anc — 


: R ae Three surprises popping 
bank management chip with a Li-polymer —— up to mark the 
3 ete : : Raspberry Fi Store's 
battery. Be careful when using lithium-ion third birthday 


batteries to enclose Raspberry Pi and the 








battery inside el (Gel oak : c =) We use cookies to ensure that we give you the best eqperience on our webaltes. By continuing to | Gori | 
; a | visit this site you agner to ouruse of cookies. Cookie golicy 


Cr ee e ) 


Network install (beta) 


° . 
e e 
° ° 
. ° 
. ° 
° ° 
. ° 
. ° 


Until recently you’ve needed to use another computer to set up Raspberry Pi. 
Typically using Raspberry Pi Imager. 

A recent development at Raspberry Pi is looking to fix this witha 
Raspberry Pi bootloader that implements network installation. If Raspberry 
Pi is connected to the internet with an Ethernet cable, it will download 
Imager from the internet and enable you to flash a microSD card or 
UISIE alr. 

You’ll need to update the bootloader on Raspberry Pi and the service 
is currently in Beta. But it’s well worth investigating to see the future of 
Raspberry Pi OS installation (magpi.cc/networkinstall). 
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Switch to an M.2 drive - 


The traditional storage for Raspberry Pi is a microSD card, 
and you can get a huge performance boost by swapping over 
to an M.2 SATA drive. This can provide ten times the storage 
transfer speed. 

If you have a Raspberry Pi 4, consider getting an Argon M.2 
case (magpi.cc/argononem2). This neat case houses an M.2 SATA 
blade in the bottom part of the case, and Raspberry Pi 4 in the top 
(repositioning and expanding the ports). 

If you have a Raspberry Pi 400, it’s possible to gain an equivalent speed 
boost with an M.2 SATA drive inside a USB enclosure (magpi.cc/m2sata). 





ee eececwr eee ree eee eee eee eee eee ee ee eee eee ee eee eee eee eee eee eee eee eee eee ee eeeeeereseeeeeeeeeeee eee ee ees 


ae 7 “Look closely at the GPIO pins 
: Pico pinout : : Ree 
on Raspberry Pi Pico 
Look closely at 
the GPIO pims Ores ee TITRE 
Raspberry Pi Pico and 


you’ ll detect that some 
of the pads are round, 

while other are square. 
The square solder pads 


‘Overclock Raspberry Pi ; 


are ground, making 

it easy to identify 
them. Take a look at 
the Raspberry Pi Pico 
pinout document 

Gant. t:4 0) eroceyg o) Cece) oyeevelti@) 





oye) ele yee ele le eyepje) ele) ee) e«) ele le 


Add a reset button. 


It’s possible to add a reset button to Raspberry 
IP Zein) DN, Mn okals al vetsin jerevel (elinl wave [peel 
marked RUN. Connect this to ground and you 
will reset Raspberry Pi, and this can be used 
with a push button to create a reset button. 
You can discover the location of the RUN (and 
other test pins) at magpi.cc/zero2testpads. 
It is also possible to connect a 
similar reset button to Raspberry Pi Pico 
(magpi.cc/picoreset). This makes it a lot easier 
to test out prototypes with the microcontroller. 


Recent updates have enabled Raspberry Pi 4 
and Raspberry Pi 400 to run at a clock speed 

of 1.8GHz. Combined with the impressive 4GB 
RAM (and 8GB on some Raspberry Pi 4 models), 
this enables Raspberry Pi to act as an effective 
desktop computer. 

It’s possible to take these Raspberry Pi models 
further, though, especially if you combine them 
with effective cooling. We’ve had a Raspberry 
Pi 4 with a cooling solution running 
at 2.147GHz. 

Take a look at our ‘How to 
overclock Raspberry Pi’ tutorial 
(magpi.cc/overclock). 
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Stephen is a retired 
software developer 
who has written 
three books on ARM 
assembly language 
programming. 

He is amember 

of Sunshine 

Coast Search and 
Rescue and enjoys 
mountain biking, 
hiking, and running. 
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Alert! 
32-bit only 


This tutorial requires 
Raspberry Pi OS (32-bit) 
and will not work with 
Raspberry Pi OS (64-bit). 


magpi.cc/osimages 





Learn ARM 





assembly language 
with Raspberry P1 


Code a small assembly language program 


gnd then compile, execute, and debug It 





the heart of a Raspberry Pi works, or how to 

write the most efficient code possible, then 
assembly language is the place to start. Raspberry 
Pi OS includes everything you need with the pre- 
installed GNU Assembler (gnu.org) and GNU 
Debugger. In this tutorial, we will show you how to 
write simple code in our favourite text editor as we 
explain assembly language instructions, and you’ |l 
learn about the architecture of the ARM CPU. 


f you’ve ever wondered how the ARM CPU at 


A small program 

Create a folder called Simple to hold your 
program. Open Geany (menu > Programming > 
Geany Programmer’s Editor) and enter the listing 
of simple.s (see magpi.cc/learnassembly1). 
Anything after an ‘@’ sign is acomment. Assembly 
language statements are in the form of: 





Label: opcode operands @ comment 
You can use any text editor, and Geany 
Programmer’s Editor is installed with Raspberry Pi 
OS. Geany has simple colour coding in the editor 
and allows you to build and execute your program. 
Save the file as simple.s in the Simple folder 

you created. 


Create the makefile 

You can enter the build steps manually 
ina Terminal prompt, but it is easier to havea 
makefile automate the process. This makefile 
creates a debug build, which includes information 
to help us use gdb (GNU Project Debugger) in a 
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later step. Although the makefile is a textfile, the 
indentations must be made with tab characters 
and not spaces. Copy, type in, and save the 
makefile, as makefile with no file extension, to the 
Simple folder. 


Build the program 
In a Terminal window, cd into the Simple 
folder, and enter the make command: 


cd Simple 
make 


Or, in Geany, choose Build > Make from the 
menu bar. 


Execute the program 
In the Terminal window, type: 


./simple 
Or, in Geany, select Build > Execute from the 
menu. You should see ‘Hello World!’ printed in 


your Terminal window. Yay, we’ve written our first 
complete assembly language program. 


Examine the machine code 
Enter the command: 


objdump -s -d simple.o > simple.lst 


4 Symbois > simples X x 
+ |) Labels 2 @ Assembly Language program to perform an 
eo 3 @ and then print “Hello World to stdout 
} start [12] 4 @ 
() helloworld (27) 5 4 RO - used to add 17 and - 
. 6 RO-R2 - parameters to Linux function s¢ 
"1 prntHw (19) T ff RT - Linux function number 
8 a 
] 
18 -Qlobal _ start @ Provide pro 
11 
12 start: HOV RO, #17 @ Use 17 for 
13 ADD RO, #2 @ Add 2 to R6 
14 BL prothw @ Call subrow 
15 HOV RT, #1 @ Service com 
16 HOV RO, #0 @ 0 return co 
17 SVC 6 @ Linux comma 
16 
19 prntHW: PUSH {R7} @ save R7 
z0 HOV RO, #1 @ param 1 is 
#1 LOR Rl, =helloworld @ string 
22 HOV R2, #13 @ length of s 
23 HOV R7, #4 @ Linux comma 
24 svc 6 @ Call Linux 
25 POP {R7} @ restore RT 
26 Bx LR @ Return from 
27 helloworld: .ASCILT “Hello World! in” 
25 


make (in directory: /home/pisasm tutorial.) 


* 
aS -9 -0 Simple.o simple.s 
Compiler ld -o simple simple.o 
Compilation finished successfully. 
line: 11/28 colO seiO INS SP MOD mode:LF  encodin 
Inspect the file with cat: 
cat simple.lst 
The file simple.Ist contains lines like: 
Q: e3a00011 mov rQ@, #17 


The bytes e3 ao 00 11 are the machine code that 
our code was assembled into. The numeral 11 is 
hexadecimal for 17. The register is o and the e3a 
part indicates which instruction we are executing 
and some options for that instruction. Each 
assembly instruction compiles to a single 32- 

bit word. A word is the natural size of data fora 
particular processor, in this case it is 32 bits or 

4, bytes in length. This is characteristic of RISC 
CPUs, allowing them to quickly load and decode 
each instruction. Even though the Ro register is 
32 bits, we can only load a small subset of values, 
since there are only 16 bits available in this 
instruction’s encoding. 


Debug the program 

We haven’t talked about what each 
statement does, so for the next few steps, we’ll 
debug through the program and talk about 
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gram starting address to Linker 


test example 

tine to print hello world 

mand code 1 terminates this program 
de from program 

nd to terminate program 


stdout 

Co print 
tring 

nd to print 
to print 
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fol g=vead Wala mer=t-lany 


subroutine 


filetype: ASM scope: unknown 


g: UTF-8 


what each statement does. In the Terminal 
window, enter: 


gdb simple 


Set a breakpoint 
The first statement in the program is: 


07 


-global _start: 


This is a label marked as global. When Raspberry Pi 
OS loads a program, it starts executing at the global 
label start. We want the debugger to stop at the 


™ We'll debug through the program and 
talk qdbout what each statement does @ 


beginning of our program when we execute it, and 
a convenient way to do this is to set a breakpoint at 
this location. All gdb commands have short forms 
to save typing, in this case b is short for breakpoint. 
Next, we can execute the program by typing the 

run command abbreviated as r. gdb will stop at the 
_start location, displaying the assembly language 
instruction that will execute next: 
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A Debugging our 
simple program 


(gdb) b _start 


in gdb Breakpoint 1 at @x10054: file simple.s, line 
a2. 
(gdb) r 
Starting program: /home/pi/asm/tutorial1/ 
simple 


Breakpoint 1, _start () at simple.s:12 
12 start: MOV RQ, #17 @ Use 17 for 
test example 


Examine the registers 

In 32-bit mode, Raspberry Pi’s ARM CPU 
has 16 registers in each CPU core. There are twelve 
general-purpose registers and four registers with 
specific purposes. To see all the registers, enter: 











(gdb) ir 


This is short for ‘info registers’. This instruction 
also shows the two program status registers 
that you test to create conditional logic. To seea 


specific register, add the register’s name, such as: 


(gdb) ir re 
re Ox@ Q 
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Notice the value of Ro, as the first instruction we 
execute will load a value into Ro. 


Single step through the addition 
To execute a single assembly language 
instruction, enter the step command into gdb (s 
for short). The ARM processor uses what is called 
a load/store architecture. That means you need to 
load data from memory into the CPU to operate on 
it, then store the value back to memory when you 
are done. 

The MOV instruction is one way to load data into 
a register; in this case, the value is embedded in 
the instruction. Next, add 2 to Ro using the ADD 
instruction. Enter the step and info commands 
below to see this in action. 








12 start: MOV RQ, #17 @ Use 17 for 
test example 

(gdb) s 

13 ADD RO, #2 @ Add 2 to RO 

(gdb) ir re 

roe Qx11 d7 

(gdb) s 

14 BL prntHwW @ Call 
subroutine to print hello world 

(gdb) ir r@ 

ro Qx13 a9 


Jump to a subroutine 

The program contains a subroutine to print 
the string ‘Hello World!’ to the Terminal window, 
to execute this prntHwW subroutine, we use the 
Branch and Link (BL) instruction. This routine 
saves the return address in the link register (LR) 
and sets the program counter (PC) to the start of 
the routine. To see this, we will check the LR and 
PC registers, single-step the BL instruction, and 
then see the effects on these registers. 








(gdb) ir Ir pc 


Ir Qx@ Q 

pc Q@x1005c Q@x1005c 
<_start+8> 

(gdb) s 


prntHW () at simple.s:19 


19 prntHW: PUSH {R7} @ save R7 

(gdb) ir Ir pc 

lie Q@x10060 65632 

pc 0x1006c 0x1006c 
<prntHwW> 


TUTORIAL | MagPi 





The LR has been set to one instruction after the BL : 
instruction and the PC is now the first instruction S | | 1p | AS 
in the subroutine. 


» Language: Assembly Language 
Single-step through 


the subroutine 
The subroutine starts with a PUSH {R7} instruction 


201. @ 
Q@02. @ Assembly Language program to perform an addition 
Q03. @ and then print “Hello World!” to stdout. 












to save the register R7 to the stack. Functions 004. @ 
and subroutines are responsible for restoring the G05. @ RO - used to add 17 and 2 
values of registers R4-R12. Before returning the Q06. @ RO-R2 - parameters to Linux function services 
subroutine calls POP {R7} to restore the saved Q07. @ R7 - Linux function number 
value from the stack. 2208. @ 
009. 
! Q@10. .global _start @ Provide program starting 
© Call the Linux write Sarasa Tike 
O11: 
command to OUTPUt U Q12. —start: MOV RQ, #17 @ Use 17 for test example 
String to Stdout i” Q13. ADD RO, #2 @ Add 2 to RO | | 
Q14. BL prntHw @ Call subroutine to print hello 
world 
Call the Linux write command to output a Q@15. MOV R7, #1 @ Service command code 1 
string to stdout. This call takes three parameters terminates this program 
that are placed in registers Ro, R1, and R2. The Q16. MOV R@, #0 @ @ return code from program 
function call number to indicate a write call is Q17. SVC Q @ Linux command to terminate 
placed in register R7. If you call a Linux service program 
from any programming language, this is the code Q18. 
that is eventually executed. The Linux function Q@19. prntHW: PUSH {R7} @ save R7 
call is initiated with the svc (Supervisor Call) 020. MOV RO, #1 @ param 1 is stdout 
instruction. This is a software interrupt anda Q@21. LDR R1, =helloworld @ string to print 
convenient way to switch execution to the Linux Q@22. MOV R2, #13 @ length of string 
kernel via an operating system interrupt handler. Q23. MOV R7, #4 @ Linux command to print 
Q24. SVC Q @ Call Linux to print 
19 prntHW: PUSH {R7} @ save R7 Q25. POP {R7} @ restore R7 
(gdb) s 026. BX LR @ Return from subroutine 
20 MOV RO, #1 @ param 1 is Q@27. helloworld: .ASCII “Hello World! \n” 
stdout 
(gdb) s 
21 LDR R1, =helloworld @ string to DOWNLOAD 
print THE FULL CODE: 
(gdb) s 
22 MOV = R2, #13. «= @ length of string mal cefile yy) magpi.cc/learnassembly1 
(gdb) s 
23 MOV R7, #4 @ Linux command 
to print >» Language: MAKE 
(gdb) s 
24 SVC Q @ Call Linux to 
print Q0@1. simple: simple.o 
(gdb) 1 rine ri F217 002. ld -o simple simple.o 
re Q@x1 1 003. 
(Al @x1008c 65676 Q04. simple.o: simple.s 
r2 @xd 13 Q@5. as -g -O Simple.o simple.s 
r7 Ox4 4 
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A Get to the heart of 
Raspberry Pi and (gdb) s 
program the CPU Hello World! 
Ea 25 POP {R7} @ restore R7 
(gdb) s 
prntHW () at simple.s:26 
26 BX LR @ Return from 
subroutine 
(gdb) s 


™ Congratulations, you have 
written your first assembly 
language program 


The LDR instruction loads the address of the string 
to print into register R1. Memory addresses are 
32-bits, and each instruction is 32-bits long, so 
how does this work since the instruction also 
holds the operation code and the register number? 
If you look at the simple.Ist file (from Step 5), 
you will notice this instruction was changed to: 
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Idr ri, [pc, #32] 


Which is a program counter relative address. The 
address is calculated by adding a small constant 
to the current value of the program counter 

to get the correct 32-bit address. This is an 
example of the GNU Assembler helping us deal 
with one of the tricky aspects of programming 
RISC processors. 


Exit the program 

After the subroutine returns, we are done. 
To exit our program, we call a Linux service to 
terminate the program. The Linux service number 
(1) goes in R7, and our program’s return code is 
placed in Ro. When the SVC instruction is executed, 
Linux terminates the process, which gdb reports. 





15 MOV R7, #1 @ Service 
command code 1 terminates this program 

(gdb) s 

16 MOV RQ, #0 @ @ return 
code from program 

(gdb) s 

17 SVC i) @ Linux 
command to terminate program 

(gdb) s 


[Inferior 1 (process 2248) exited normally] 


To exit gdb, press CTRL+D. 

Congratulations, you have written your first 
assembly language program. Why don’t you try 
making changes, for instance change the ADD 
instruction to SUB or MUL? Perhaps change what 
is printed or see what happens if you change the 
program’s return code. The only way to truly learn 
a new programming technique is to experiment 
and learn by doing. Wl 





Stephen's stuff 


Stephen has written three books on 
assembly language programming. The 
first, Raspberry Pi Assembly Language 
Programming, is the place to go fora 
deeper understanding of the topics touched 
on in this tutorial. The second is Programming 
with 64-Bit ARM Assembly Language, and the third is 
RP2040 Assembly Language Programming for the 
Raspberry Pi Pico. 
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Retro Gaming with Raspberry Pi shows you how to set up a 
Raspberry Pi to play classic games. Build your own games console 
or full-size arcade cabinet, install emulation software and download 
classic arcade games with our step-by-step guides. Want to make 
games? Learn how to code your own with Python and Pygame Zero. 
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K.G, 
Orphanides 





K.G. now has 
enough GM/GS 
MIDI devices to 
create an entire 
dungeon synth 
orchestra. 


@KGOrphanides 


You'll Need 


> mt32-pi project 
from issue 114 
magpi.cc/114 


>» Reaper 
reaper.fm 


> USB MIDI keyboard 
magpi.cc/ 
vortexwireless2 


> Enable your 
desired MIDI 
inputs and output 
devices in Reaper's 
preferences 





Set up a digital 
audio workstation 


Build gd powerful digital gudio workstation setup for MIDI composition with 
Reaper, Raspberry Pi OS 64-bit, and a dedicated mt32-p! external synth 


synth from issue #114 (magpi.cc/114) to 

make music. We’ll use a Raspberry Pi 4 8GB 
model with Raspberry Pi OS 64-bit as our main 
computer, running our digital audio workstation 
(DAW) software, and connect our mt32-pi to it using 
two sets of USB MIDI adapters, as discussed in the 
previous tutorial. We built our mt32-pi with a 4GB 
Raspberry Pi 4 and a HiFiBerry DAC+ACD audio HAT, 
but any mt32-pi build will do the trick, as will an 
off-the-shelf external synth like the Roland MT-32 
and SC-55 we used in issue 111 (magpi.cc/111). 


T his month, we’re using our mt32-pi MIDI 


Connect your audio hardware 
Connect the usual monitor, keyboard, and 
mouse to a Raspberry Pi that you’1l be using as 
your DAW computer. Plug a USB MIDI adapter into 
any of its USB ports. If you have one, connect a 
USB MIDI keyboard. 

Next, connect mt32-pi’s audio outputs 
(preferably on a dedicated audio HAT) to your 
speakers, and plug in a USB MIDI adapter. 

Connect the MIDI IN cable from each adapter to 
the MIDI OUT cable of the other, and vice versa. 
Remember that some USB MIDI adapters, such as 
the industry-standard Roland UM-ONE mkz2, label 
their MIDI IN as ‘Connect to MIDI OUT’ and their 
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A The red a2jmidid blocks give you one JACK MIDI port for 
every ALSA sequencer port. Configuring Reaper's inputs 
and outputs will automatically connect them in QjackCtl 


MIDI OUT as ‘Connect to MIDI IN’. 
Connect power to both Raspberry Pi computers. 


Download and extract Reaper 

Reaper is outstanding, professional-grade 
digital audio workstation software. It’s free to try 
for 60 days, but a single-user, multi-device licence 
costs S60 and is well worth getting if you find the 
software useful. Go to reaper.fm, click Download, 
and select the appropriate version for your OS 
— that should be Linux aarch64 if you’ re using 
Raspberry Pi OS 64-bit, and Linux armv7] if you’re 
using a 32-bit version. Create a folder in your home 
directory called Software, copy the downloaded file 
to it, and extract it via the right-click menu. 


Install dependencies 

Although you can run or install Reaper 
straight away, we’re going to install some 
dependencies and optional components first. Open 
a Terminal and type: 





b (o) 0 or- la Mexe)alal-roim <a, oey-lcet-w-lalemeldal=le 
MIDI instruments to a Raspberry Pi 
qUlalallavem datum BAN (Avi t- mes) = ime) mexe) glaives 
them to the MIDI IN DIN plug on the 
DAW’'s USB MIDI adapter 


sudo apt install jackd qjackctl vlc ffmpeg 
lame a2jmidid 


Most of these will probably already be installed, 
but JACK in particular is an important optional 
component, particularly if you want to handle PCM 
audio in real time, as well as MIDI. We’11 use the 
a2jmidid package to automatically bridge ALSA’s 
MIDI sequencer ports to JACK. 


Install Reaper 

Open a Terminal, cd to the folder you copied 
Reaper to and run its installer. For our 64-bit build, 
that looks like: 


cd ~/Software/reaper_linux_aarch64 
sh install _reaper.sh 


Reaper’s installer gives you a few different 
options. Type R to try it out without installing it. 
Type I to install it in either opt or ~opt — you’11 
probably be prompted for your root password 
during this process if you choose the former. 

Or type A to add desktop integrations and file 
associations for the Reaper executable in its 
current path. 


MagPi 
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We’re going to press I to install it, then 1 to put it 
in /opt/REAPER, Y to install desktop integrations, Y 
to create relevant symlinks, and Y again to proceed. 


Configure JACK 
Type qjackct1 at the Terminal to load GUI 


controls for the JACK low-latency audio. Press 
Start on QjackCtl, then open a fresh Terminal and 
type a2jmidid -e. In QjackCtl, click Graph to see 
your MIDI and PCM audio connections. Disconnect 
everything by pressing CTRL+tC and then clicking 
Disconnect in the toolbar. Test your keyboard 

and mt32-pi by dragging a connection from your 
keyboard’s a2j capture interface - ‘Vortex Wireless 
2 [32] (capture)’ in our screenshots — to mt32-pi’s 


Set up a digital audio workstation 





QjackCtl can 
automatically start 
and kill a2jmidid, 
getting you ready to 
make music faster 


Top Tip 


Other voices 


We're using our 
mt32-pi with 
Roland SC-55 
GM/GS voices, 
but more GM- 
compatible 
SoundFonts 

can be found 

at magpi.cc/ 
mt32soundfonts. 
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A Channel your inner 
1980s band member 
with a Vortex 
Wireless 2 keytar 


a2j playback interface, which will be something 
like our ‘USB MIDI Interface [28] (playback)’. Make 
sure your speakers are on and play a few notes. 
Select everything again and disconnect. 


Configure Reaper 

Start Reaper from Raspberry Pi’s Sound 
& Video menu. When you start Reaper, you’ |l 
be informed that it isn’t free software and that 
you should register it after 60 days. Close this 
by clicking Still Evaluating, and continue. Go to 
Options > Preferences and select MIDI Devices 
under Audio. All your a2j (ALSA to JACK) MIDI ports 
should be here. Double-click on the entry for your 
MIDI instrument under the top inputs section and 
click ‘Enable input from this device’. Click OK. In 
the outputs section below, double-click the entry 
for your USB MIDI interface and tick ‘Enable output 
to this device’. Click OK. You can also enable input 


A You can select a MIDI input - or even specific channels 
- for each Reaper track. This also makes it easy to use 
multiple MIDI input devices 
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or output from the right-click menu of each device. 
Click Apply and OK. 


07 Prepare a MIDI track 

Right-click in the blank area at the left- 
hand side of the screen and select Insert new 
track. You can also press CTRL+T to do this. Click 
the round red record button on the track you’ve 
just created to arm it, then left-click where it now 
says ‘Input 1: not connected’. Mouse across your 
a2] MIDI keyboard entry and select ‘All channels’. 
Now when you press a key, a yellow level meter 
should flicker on the channel. We’re now at the 
point where we can record some MIDI, but we still 
need to hear what we’re playing. In the mixer 
panel at the bottom of the screen, you’ll see a 
mixer to go with our track. Click the stripy Route 
button and under MIDI Hardware Output, select 
the a2j USB MIDI Interface entry. 








A Reaper MIDI outputs are most easily assigned on a per-track 
basis. Composers who use multiple MIDI tracks often make a 
template file with MIDI outputs already assigned 


Make a test recording 

Make sure the playhead (the position 
indicator on the timeline) is at the beginning. 
Press the red record button on the main control 
panel above the mixers and play something on 
your MIDI instrument. This should default toa 
general MIDI piano sound, which you should hear 
in real time as you play. Click the red button again 
to stop when you’ve finished, and click Save All 
when asked which files you want to save. Note 
that this doesn’t save your entire project — press 
CTRL#S to do that. Now press play — right next 
to the record button — to listen to your work. 
Press stop when it gets to the end, and return the 
playhead to the beginning. 


Control your MIDI instruments 

Make sure the playhead (the position 
indicator on the timeline) is at the beginning. 
Press the red record button on the main control 
panel above the mixers and play something on 
your MIDI. 


Automatically launch a2jmidid 
with JACK 
Having established that everything works, it would 
make life a lot easier if all our audio daemons 
launched together. Open QjackCtl’s Setup menu and 
go to Options. Tick ‘Execute script after Startup’ and 
add the following to its text entry box: 


a2jmidid -e & 


And in the same way, add the following command 
to ‘Execute script after Shutdown’: 


killall a2jmidid 
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A Reaper looks a little austere by default. 
Adding themes will help 
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<4 The ReaControlMID! 
FX plug-in allows 
you to command 
your external 
hardware MIDI synth 
to change voices 





Add PCM qudio recording 


As a fully-fledged DAW, Reaper can also 
record analogue instruments as real-time PCM 
audio, but you’ll need a USB audio interface such 
as a Focusrite Scarlett to connect microphones, 
guitars or other instruments to Raspberry Pi, as it 
lacks any audio input and its integrated BCM2835 
analogue audio output isn’t production-quality, 
either. If you want to export a project with both 
MIDI and PCM tracks, you can use the FluidSynth 
SoundFont synthesizer (fluidsynth.org) to render 
MIDI tracks into PCM or use an external mixing 
desk to route all audio to a recording device. 
Raspberry Pi isn’t hugely powerful, which limits 
Simultaneous multi-track recording, but it is 
absolutely silent, making it a useful studio device. 





Why an external MIDI synth? 
Raspberry Pi 4, particularly the 8GB version 
running a 64-bit OS, packs in a lot of power for 
its size and price. However, audio processing 
can be resource-intensive. While we could get 
the same sounds by running FluidSynth ora 
FluidSynth-based VST on our DAW system and 
routing everything through that, you’re making 
Raspberry Pi do more work than it has to. Using 
mt32-pi — or any vintage or modern external MIDI 
synth — takes some of the load off. This comes in 
particularly handy if you’re recording PCM audio 
alongside MIDI. 


1s SE ————— 





TopTip @& 


Pay the Reaper 


If you find Reaper's 
professional- 
grade recording 
environment 
useful, don't 
forget to register it 
at reaper.fm. 


sat a 
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A Arange of comfortable and even colourful 
themes are available at Reaper's website 
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Phil King 





Long-time 
contributor to The 
MagPi, Philis a 
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You'll Need 


>» Linux or 
Windows PC 


>» CDP Studio 
cdpstudio.com/ 
getstarted 


> Raspberry Pi 


> Raspberry Pi OS 
(Bullseye or Legacy 
version, 32-bit) 


>» 3x LEDs 
> 3x 330 resistors 


> Jumper wires 


> Figure 1 The wiring 
diagram for the 
LEDs circuit 








CDP Studio: 
Trigger LED 
patterns wilt 


=~ a web GUI 


Use the low-code, block-based environment of CDP 
Studio to create and deploy a Raspberry P! project 


n ‘out of the box’ software development 
tool, CDP Studio is used by numerous 
companies to build industrial control, 
automation, and edge systems. Yet, it’s fairly easy 
to get to grips with its low-code programming 
environment. Better yet, you can deploy projects 
to a Raspberry Pi — this is often used for testing 
and prototyping purposes in industrial settings. 

In this introductory tutorial, we’ll guide you 
through the process of creating an app to flash 
LEDs connected to a Raspberry Pi in different 
patterns, selectable on a web GUI. We’1l mainly 
be using CDP Studio’s Block Diagram mode, 
connecting various preset block components, 
although we’ll also do a tiny bit of hard coding in 
C++ to create a new custom function. 


B 
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Install the software 

Visit cdpstudio.com/getstarted and 
download the free non-commercial version for 
Linux or Windows. During installation, make 
sure you select both Raspberry Pi ARMv8 32- 
bit (Debian 11) and Raspberry Pi ARMv6 32-bit 
(Debian 10) components, along with the one 
already ticked for your host PC. You will then be 
able to deploy projects to any Raspberry Pi model, 
using Raspberry Pi OS Bullseye or Legacy version, 
by selecting the appropriate toolkit in CDP Studio. 


Create a library 

For this project, we’ll create a library to 
house a custom function. Components created in 
libraries can be used easily in other projects. 

Go to Create New > Library and enter a name for 
it (we called our library ‘LEDs’ ). Right-click your 
library in left panel and select Add New. Select the 
CDP Port Model in the dialog and click Choose. 
Click Next, then enter name for it (LEDPort in our 
case), then click Next and Finish. 

At the bottom of the LEDPort.cpp C++ code file 
that appears, right-click UserProperty and select 
CDP > Change, then add a name for it (LEDPort). 
Change the Type to bool, then click OK. This will 
auto-create an LEDPort.h header file. 

In LEDPort.cpp, we need to add extra properties 
for two more LED patterns. Add a new line under 


ff 


a Mal=m e)ge)(-reim ome (=)0)Ke)V/-r0| 
from the CDP Studio PC 
to Raspberry Pi via SSH 


The three LEDs are 
dale le(-1e-ceMlamsalgsi— 
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LED1.Create, then right-click and select CDP > Add 
> Property. Name it LED2 and change its Type to 
bool, and Routing Type to Periodic. Tick the box 
for Create Another. Click OK, then name this one 
LED3; untick Create Another, then click OK. 

Finally, we need to build the library. Right-click 
the LEDs library name in the left panel and select 
Build, then Save All. 


First LED pattern 

For our first pattern, we’ll create a custom 
component. Switch to Configure mode and right- 
click your LEDs library name in the left panel, then 
Add New > CDP Component Model. Click Choose, 
then Next; in the Component Model parameters, 
give it aclass name (LEDSine), and change the 
Frequency to 2 (cycles per second). Click Next, 
then Finish. 

The LEDSine.cpp file will be auto-created. Right- 
click in its code, then select CDP > Add > Port. In 
the Port type drop-down, select LEDS::LEDPort (the 
one you created). We’ll name it ‘LEDs’. 

Under /* Write your code here */ in 
LEDSine.cpp, add the following (indented) code: 


LEDs.LED1 
LEDs.LED2 (counter==1) ; 
LEDs.LED3 = (counter==2); 
counter += increment; 


(counter==@) ; 





AV (Kem eo) cele l eclaamtal=m e) ge) (-1ea8 
on a PC. When deployed 
to Raspberry Pi, the web 
Ul can be accessed 
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if (counter==@ || counter ==2) 
increment*=-1; 


In the LEDSine.h header, under LEDPort LEDs;, 
add these two lines to create the counter and 
increment variables: 


int counter = @; 
int increment = 1; 


Build the LEDs library again. In Configure mode, 
under LEDs in the Resources panel, we now have 
the LEDSine component available. 


Main block structure 

Right-click in the left panel and select 
Create New > CDP System. Give it a name 
(RPiILEDs), click Next twice, then Finish. In the 
Block Diagram tab of Configure mode, you’ ll now 
see the main block for the project. Double-click 


Chieti + 
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Random issue 


When the project 
is deployed ona 
Windows PC, the 
three AddRandom 
blocks will set the 
same value at the 
same time, turning 
all three LEDs 
on/off together. 
When deployed 
to Raspberry Pi, 
however, each 
individual LED will 
toggle randomly. 





<The main block 
diagram for the LEDs 
app in CDP Studio, 
with the three LED 
functions on the 
left. The web GUI is 
also shown here ina 
browser window 
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A Pairing CDP Studio 
with a Raspberry 
Pi on the wireless 
network via SSH. It 
will also need its 
Zetc/security/ 
limits.conf file 
modified - see 
magpi.cc/ 
cdprpisetup 


TopTip @ 


Deploy on PC 


Before deploying 
the project on 
Raspberry Pi, you 
may want to test 
it by running it 
on the local PC, 
in which case 
the web GUI is at 
127.0.0.1:7689/ 
index.html. 





it (or select RPILEDsApp in the left panel) to see 
inside. We can now Start adding program blocks. 

In the bottom left Resources panel of Configure 
mode, open the CDPCore category and draga 
CDPComponent into the diagram. Drag another 
CDPComponent underneath it. Then open 
the LEDs category in Resources to find your 
LEDSine component; drag it under the two 
CDPComponent blocks. 

Click on LEDs on the LEDSine block and untick 
Input in the right-hand panel, to make it an 
output. Select LEDSine in the LEDs library. In the 
Table Editor tab, click the right arrow next to LEDs 
(under Ports) and untick Input there too. 

Back in the Block Diagram view for RPiLEDsApp, 
open CDPCore in Resources and drag a PortMUX 
block into the diagram. This acts as a multiplexer 
for the three LED patterns, avoiding complex, 
messy individual wiring. 

Drag another CDPComponent to the right of 
PortMUX. Right-click and rename it IO. This block 
will house our GPIO server. 

Now drag over a CDPPort (under CDPCore) into 
both CDPComponent blocks. Select it in each 
block and untick Input in the right-hand panel, to 
change it to an output. 


PortMUX inputs 

Now to add more inputs to our PortMUX 
block. From LEDs in Resources, drag an LEDPort 
into the PortMUX block. Select it and, in the right- 
hand panel, rename it ‘Off’. 

From CDPCore, add three CDPPorts to the 
PortMUX block -— these are for our three LED 
patterns. Rename CDPPort to Rand, CDPPort1 
to Scan, and CDPPort2 to Sine. From LEDs in 
Resources, drag an LEDPort into PortMUX; untick 
Input in the right-hand panel. 

It’s time to make our first connection: drag a 
wire from the LEDs output of the LEDSine block to 
the Sine input on PortMUX. 


10 block 
Adda cCDPPort to the IO block and rename it 


LEDs, then connect the LEDs output of PortMUX to it. 
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A Weneed to add a few lines of C++ code for our custom 
function's LEDSine.cpp file 


Now to add our GPIO server for Raspberry Pi. 
Double-click the IO block, then open GPIOPinIO 
in Resources and drag a GPIOServer into IO. 

With GPIOServer selected, right-click GPIOPin 

in Resources and select Add Multiple. Change its 
name to LED1 and increase Count to 3. Click OK to 
create three outputs — LED1, LED2, LED3; change 
them all to inputs. 

Select the LEDs block in IO. Open CDPCore in 
Resources and drag three PushConnection outputs 
into the LEDs block. Rename them LED1, LED2, 
and LED3. Now connect the LED1, LED2, LED3 
outputs of LEDs block to the LED1, LED2, LED3 
inputs of the GPIOServer block. 

We need to enter the GPIO pin numbers for our 
circuit’s LEDs (Figure 1). Select each of the LED1, 
LED2, LED3 inputs on the GP!OServer in turn 
and set its Nr value (right panel) to the GPIO pin 
number: 14, 15, and 18 respectively. 


07 More LED functions 

Back in RPiLEDApp, rename the 
top CDPComponent to LEDRand, and the 
other CDPComponent to LEDScan. Rename both 
their CDPPorts to LEDs. Connect them up to the 
Rand and Scan inputs on PortMUX. 

We'll create both of those functions using existing 
elements and no hard coding. Open LEDRand, 
select the LEDs block, and add three PullConnection 
inputs. Rename them LED1, LED2, and LED3. 

From Automation in Resources, drag an 
AddRandom <unsigned char> component to the left 
of the LEDs block. Change its Upper value to 2 in the 
right-hand panel — it will generate values that will 
be interpreted as a1or 0, to turn an LED on or off. 

Connect its Out output to the LED1 input on the 
LEDs block. Let’s create two more AddRandom 
blocks. Right-click the existing AddRandom 
block and Copy and Paste into a blank area of the 
diagram, then select Add. Repeat this process to 
add a third AddRandom block. Connect the two 
new blocks’ Outs to the LED2 and LED3 inputs 
respectively on the LEDs block. In the right-hand 





panel, change the fs (i.e. frequency) of LEDRand 
to 2 (or whatever you prefer) to slow it down. 


Scan function 

Our LEDScan function flashes the LEDs in 
sequence, using bit shifting. We don’t have room 
here to describe its creation in detail, but you can 
recreate it or copy it directly (by holding SHIFT 
while dragging over it) from the downloadable 
project (magpi.cc/github). If you do copy it over, 
make sure to copy the three LED1, 2, 3, connections 
(right panel) from the LEDScan block into the LEDs 
block you created earlier for your LEDScan function, 
then delete the copied-over LEDScan block. 

In your LEDScan function, select Count on the 
left and untick Input, then connect the Out of the 
MUX block to it. We need to loop it back to the 
start, so right-click Count and Copy Path. Select 
the In of the ShiftLeft block and paste the path into 
the Routing field. 

Finally, check the values (right panel) are the 
same as those in the downloaded project version 
for the ShiftLeft, GT, and MUX blocks. Change the 
LEDScan function’s fs property to 2 to slow down 
the sequence. 


Web GUI 

Let’s add a web GUI to control the program. 
Right-click RPiLEDsApp in the top-left panel and 
Add New > Add Web UI. Use the default options in 
the dialog. 

Switch to Design mode to start designing the UI. 
Delete the existing text box, then drag a Grid Layout 
element into the canvas. Drag four Buttons into 
it. Drag a Lamp (representing an LED) to the right 
of the second button from the top. Then drag two 
more Lamps to the right of the lower buttons. Drag 
a Label to the right of the top button; double-click 
it and change it to ‘LEDs’. Double-click the buttons 
and label them: Off, Rand, Scan, and Sine. 

Select the Off button. In the bottom-right panel, 
scroll down to cdpCheckedRouting. Here you’ 1] need 
to input the routing for the button so it works. To do 
so, return to the RPiLEDsApp diagram, right-click 
Index on PortMUX, and Copy Path. Back in Design 
mode, paste it into the cdpCheckedRouting field for 
the Off button. Tick checkableByEmitValue. 

For the Rand button, tick checkableByEmitValue 
and change valueToEmit to 1; paste the path (as 
before) into cdpCheckedRouting. Repeat this 
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A Asimple LED 
circuit is connected 
to Raspberry Pi's 
GPIO pins 


for the other buttons, with valueToEmit set to 2 
and 3 respectively. 

Now to route the Lamps. In the Block Diagram, 
select the LEDPort output on PortMUX, then right- 
click LED1 (right panel) and Copy Path. In Design 
mode, select the top Lamp and paste the path into 
its cdpStyleRouting field. Select each of the other 
Lamps, then paste the path into cdpStyleRouting 
and change the last digit to 2 and 3 respectively. 


Ready to deploy 

In Configure Mode, select the LEDs library 
and the Deploy Configuration tab. Tick the box for 
Raspberry Pi ARMv6 and/or ARMv8 under Toolkits. 
Rebuild the library. 

Make sure your Raspberry Pi has SSH enabled 
and you’ve modified its /etc/security/limits.conf 
file - see magpi.cc/cdprpisetup for details. Wire 
up the LEDs circuit as in Figure 1. 

To find your Raspberry Pi from CDP Studio, in 
Deploy Configuration for RPiLEDsApp, click Select 
next to WiFi under Networks to show devices. 
Enter pi as the Username and click Pair, then enter 
Raspberry Pi’s password. 

Choose the appropriate Toolkit for your 
Raspberry Pi OS version; under Device, select your 
Raspberry Pi’s IP address. Right-click RPiLEDs in 
the left panel and select Run & Connect. The web 
UI can be found at your Raspberry Pi’s IP address 
followed by :7869/index.html - for example, ours 
Was 192.168.1.112:7689/index.html. You can now 
click the UI buttons to change the LED pattern. 
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ast February, my children 
rushed in with a copy of the 
latest HackSpace magazine 
for me, excited because of the 


gold lettering and free gift on 
the cover. [he gift was a microcontroller, 
and my children’s enthusiasm was a catalyst 
for me to come up with a project that would 
appeal to and involve them. This would 
be the first project that | had done with a 
microcontroller. | picked the Python route 
as it seemed the closest step from BASIC 
that | had used many years ago at school. 
| worked through the tutorials published in 
HackSpace issue 39 (hsmag.cc/issue39), 
and these gave me a good understanding 
of how to flash the Pico with Python and 


connect components. If you are starting out 
with the Pico, | recommend this as a great 
place to begin. 

With small children, we have an 
abundance of toy cars and building bricks 
and, whilst rolling cars down improvised 
tracks built from books and supported by 
DUPLO, | thought it would be great if we 


could set up a race track and use the Pico 

to determine the winner. After research on 

l l Wheels 

s and 

w | could 
ded to find 
iration 

ult. | took 
aler to find 
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What I used 


Raspberry Pi Pico 

4 x red LEDs 

4 x green LEDs 

8 x 3300 resistors 
Transistor and resistor 
Piezo buzzer 

2x3mm break beam sensors 
Push-to-make button 
Electrical wire 
Stripboard 

Race track 

Toy cars 


the optimum width for the cars to run along 
(38mm) and the 2m lengths easily flexed 

to fit Into the car. Hot Wheels track would 
be another option but, for a fair race, the 
competing tracks would need to be identical 
and quite a large collection would be 
needed. A 3D-printed adapter could probably 
be made to incorporate loops and jumps to 
add to the excitement. 

In terms of components and materials for 
the build, this is a low-cost project (£380 or 
less, depending on components you already 
have). Of course, you will need a soldering 
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HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc. 
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Above * 

Custom brick to 
hold and connector 
to join the track 





iron and a computer to program the Pico, but 
other parts can be adapted or improvised 
using whatever you have available. | chose 
to house the sensors in 3D-printed parts that 
fit to DUPLO because | could save a lot of 
printing time. All that was needed was a few 
bespoke bricks. Thingiverse proved a great 
starting point with bricks that could be 
modified to fit the chosen sensor. On 
Thingiverse, ‘klamowk’ has published a 
customisable DUPLO-compatible brick: 
thingiverse.com/ 
thing:4815088. The required 
size can be entered, which 
takes the hard work out of 
making a brick that will fit to 
others. Other benefits of 
using DUPLO are that you 
don't need much space to 
store the completed project 
because It can easily be 
disassembled, and the layout 
can be varied every time. 
Don't be put off doing a similar project at this 
point if you haven't got access to a 3D 
printer — you could easily mount the sensors 
in wood or even cardboard. 


THE TRACK 

The track on its own is quite flexible so 
does need supporting. | designed a track 
connector that slides over two pieces of 
conduit to join them. If you don’t have a 3D 
printer, the track could easily be supported 
and joined by fixing it to a batten (this would 
be very rigid, but not so easy to collapse 

to store). DUPLO towers were used at 
intervals to support the track along Its length 
up to the finish line, with custom bricks 
holding it in place. | got the children involved 
in building the towers, and we were having 
fun racing cars even before I'd started on 
the electronics. 


BREAK BEAM SENSORS 

We tried timing the races manually, and 
the children realised how difficult it was 

to tell by eye which car had won the race. 
Browsing the available sensors, | came 
across the Adafruit Breakbeam sensor 
(hsmag.cc/BreakBeam), which will operate 
at the Pico’s 3.3V (certainly over the distance 
needed for the project). There are two 
parts (an infrared LED and a sensor) and, 
as both components are the same size, | 
was able to design a brick that could be 
used for both and know that they would 

be perfectly aligned. | chose to place the 
sensor vertically above and below the 
finish line. The conduit track can easily be 
drilled to allow the beam to pass through 
without compromising the car’s path. Once 
connected to the Pico, the pin is high until 
the beam Is broken. | set up a trigger event 
to capture the pin going low (see Code 1 
listing). The code run by the trigger event is 
really simple: if an in_a_race flag is set to 
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breakbeam1 = Pin(5, Pin.IN, Pin.PULL_UP) 


def beam1broken(pin): 
#set beam broken flag only if in a race 
global beam1_broken 
if in_a_race == True: 
beam1_broken = True 


breakbeam1.irq(trigger=Pin.IRQ_FALLING, handler=beam1broken) 





Left < 
Assembled finish 


fine; eangior | did start looking at options such as 


track to be fitted adapting an SPI module which would have 
Below & only required a few wires. | opted to keep 
er eels things simple, and connected each LED to a 
house LEDs pin on the Pico as there were plenty available 


for this project. The eight LEDs were 
soldered onto a stripboard with appropriate 
resistors, as this ensured the correct spacing 
for the printed door. The finished circuit fitted 
nicely into the window casement. 

We thought it would be fun to have an 
audible start to the race, but the first piezo 
buzzer | used was far too quiet. | purchased 
a louder one on eBay, which | thought had a 
built-in transistor to operate (as there is not 
enough current to power direct from the 
pin). After testing, it turned out there was no 
True, then the beam1_broken variable is set to transistor, but once | wired it up with an 
True. The rest of the code is within the main external one, it provided a good loud beep. ~ 
loop so that the trigger code is run as quickly 
as possible. Initially, | had thought | would 
need to deal with multiple signals as the 
car passed through the beam. But actually, 
| haven't had any trouble with false triggers 
and | just need to know the first instance of 
the beam being broken. 





STARTING LIGHTS 

Rather than a basic stop/go light, | wanted 
to create the feel of a race track starting 
grid with a series of red and green lights 
similar to those seen on Formula 1. | started 
designing a brick to house the lights, but 
realised a DUPLO window brick combined 
with a 3D-printed front panel for housing 
the starting lights would considerably cut 





Right 2 


down the printing time and, of course, Stripboard 
: or ensures correct 
a blank was available on Thingiverse spacing of LEDs 


thingiverse.com/thing:2888128. 
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End of the race 


OOOO connectors make the project easier 


to take apart, but are not essential. 


OO@®@ | added some extra connections to 
facilitate future upgrades. The circuit 
OOOO was covered with a 3D-printed DUPLO 
brick-size case. A downside of using 
DUPLO for the construction is that there is 





Above * 
Red lights alternate to nowhere to route the cables. If repeating this 
how 1st and 2nd pl . Cente 
SOMES ANEAENES yroiect, | would have built the starting lights 
Left 5 and control box into one enclosure to reduce 


Completed starting lights . 
the number of exposed wires. 





ooo" ‘ To program the light and beep sequence THE CODE 
(see image above), | created a starting light The main code is a loop within which there 
routine which can be called from the main is a sub loop that runs while a race is taking 
loop each time a race is started. place. This sub loop looks to determine 


The race is started (or reset) by pressing a if an event has been triggered by a beam 
button mounted in a printed custom DUPLO being broken. If it is the first occurrence, It 





oe brick. In the future, | would like to change is recorded as the winner, and the second 
starting Sequence this to a remote control to reduce the occurrence finishes the race and lights 
B@aooO number of wires. display the final race positions. 
The lights also perform a second function; The setup can be run connected to the 
OOOO they are used to show first and second place computer, but as the intention was to have 
at the end of the race, with the red lights this as a standalone toy, | saved the code 
OOOO flashing accordingly to indicate the winner on the Pico as main.py so that it would run 
@O0d0O (see End of the race, above). each time the circuit was powered. | used 
a USB power adapter, but a battery would 
OOOO BRINGING ALL THE make this even more portable. 
PARTS TOGETHER 
@@OoOO After initially testing the various parts on a IN ACTION 
breadboard, | decided to make the wiring After some initial testing, the track was put 
OOOO more permanent using stripboard. The JST to use at a party. Children quickly got to 
| Short beep | grips with how to operate and interpret the 
OOOO results. Initially they were just racing cars, 
but soon they wanted to answer questions 
© OOO | & like, “Which types of cars were fastest?” 
O OOO ) and “Does the same car always win?” 
FUTURE IDEAS 
In terms of construction, there are plenty 
of potential enhancements, such as ramps 
and jumps or even a car launcher. These 
could be 3D-printed or made from cardboard. 
An upgrade to the electronics would be to 
Above * display the race finishing times (the full code 
Starting sequence : : : ' 
already stores the times In variables which 
on Sennution could be output to a display). Older children 
printed DUPLO brick might enjoy the challenge of modifying 
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the code further. For example, a relay race 
where as many cars as possible are sent 
down the track in two minutes, or a time trial 
which uses both of the sensors on the same 
track and measures the time between the 
two to calculate the speed. 


CONCLUSION 

The Pico Drag Race Track has provided us 
with hours of entertainment, and the ease 
with which it can be packed up, transported, 
and reassembled has meant it has made 
regular appearances at family gatherings. 
This project has developed my 3D printing, 
electronics, and programming skills and has 
also been fun to build, especially as I've 
been able to involve my children with so 
much of the process. It is an accessible and 
versatile project that can be adapted in many 
different ways (if cars aren't your thing, how 
about modifying this for a marble run?). I’ve 
put the code and 3D models on a Facebook 
group, hsmag.cc/PicoRace, should you 
want to create something similar. & 
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When button Is pressed to start the race 
e Call the starting lights and beeps routine 
e — Enter the in-race loop 
° First car past the finish line — record 
the winner 
° Second car past the finish line — the 
race is finished 
e When race has finished, exit the race loop 
e Display the winner 
Repeat 














Above * 
The schematic for 
the circuit 


Below / 
Race track in action 
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Astrophotography with Raspberry Pl. By Rob Zwetsloot 
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pace is very cool. Stars, planets, . WA — 
nebulae, and the Moon are very | ri At \e 
pretty as well. However, getting a 


good photo of the night sky can be difficult 
without specialised equipment, even if you 
own a telescope yourself. 
Thanks to Raspberry Pi and its powerful 
camera functionality, and the open- 
source night sky trackers you can install 
to it as well, you can quickly improve your 
astrophotography — whether that’s peering 
up into the sky with the camera directly or 
going through a high-powered telescope. 
Space is very cool. Let’s capture some of 
that cool. 
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Space VIEWS 


Get g better look without investing in tech 


hile electronics and telescopes will help 
W you get some really great views and shots, 

you can use these low-tech methods to 
get a better look than with the naked eye. 


Vaeewet tl, 
s 


DSLAIR 
camera 


While these are higher tech, they're not 
particularly designed for astronomy. Still, with 
a tripod, as long a lens as you can find, and a 
long exposure time, you can get some great 
photos. Check out this guide for more info on 
how to do it: magpi.cc/astrodslr. 








Credit: Jacek Halicki CC BY-SA 4.0 


Binoculars 


While there are binoculars that are more specifically designed for stargazing, any decent 
pair can be pointed up when it's night. You'll get better views of the Moon, actually see Mars, 
and even potentially see some of the moons of Jupiter if you look at the right time of year. 


Credit: Jacek Halicki CC BY-SA 4.0 
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Different ways to capture the cosmos 





y ou can take incredible photos with the 
Camera Module or High Quality Camera 
and Raspberry Pi using a few clever 

tricks with lenses, exposure, and maybe even 
a telescope. 





James Mitchell (raspberryjamberlin) 


The Raspberry Pi Moon Camera is something 
we featured way back in issue 45. What makes ~ 
this system quite unique is the use of a custom, A Using a 3D-printed lens adapter, you can use powerful 
3D-printed lens adapter that allows you to attach lenses with a standard Raspberry Pi Camera Module 
traditional lenses to a Raspberry Pi Camera Module 
— long before the High Quality Camera came along 
with interchangeable lenses. In this case, they 
were Canon EF (EOS) lenses. 

The shots James got were quite remarkable, and 
only used the default settings: “I’m embarrassed 
to say I left it on auto. In fact, the command | 
used had no modifiers at all —- raspistill -o 
moon. jpg. What | got really was a happy accident. 
Could I improve the picture with changing some 
settings? Absolutely!... I think I need to learn more 
about how the optics work. Maybe I could adjust 
the distance between the lens and the sensor to 
improve the sharpness.” 

Interestingly, the most expensive part of a 
project like this is the lens. 








A Agreat picture of the Moon captured with the camera 





| 


While this camera may look a little low-tech, it actually uses a lot of smart 
techniques to not only see more of the sky, but automatically take photos 
of anything bright that appears in it. It makes use of a HQ Camera anda 
180-degree CS lens beneath an acrylic dome to protect it from the elements. 

It uses software called Meteotux Pi, written by Jippo’s amateur astronomy 
friend Jani, which does a lot of the heavy lifting, allowing the whole setup to 
stay relatively cheap. 

“After Meteotux Pi has taken the images, a Python Shell script starts to 
generate star trails and normal video from stacked images,” Jippo tells us. 
“This script uses ImageMagick and FFmpeg and when they are ready, [it] 
moves those images and videos to my network drive via WiFi where I can 
check them.” 


Santiago Rodriguez 





This is quite the beefy piece of kit, combining a 
telescope and a HQ Camera with some custom 
software to control image taking. It’s no 
wonder that it was created by a physics student 
like Santiago. 

This setup doesn’t have a dedicated star tracker, 
but Santiago loaded Raspberry Pi with KStars, 
which gives a live view of the night sky that 
he could use to find celestial objects. He’s able 
to control exposure, ISO, and shutter speed - 
although there are some limitations to that shutter “4 
speed as it’s digital. Still, he’s able to use multiple ay) : 
exposures to approximate a long exposure. 





Official Moon 
Shots 
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This image of a satellite 
makes us think the images 
from a meteor shower would 
be fantastic 


A very unassuming 
setup for a fairly cool 
astrophotography project 





. While a small telescope, 


it’s still great for looking 
at the night sky 





i An extreme close-up 


of the Moon, possible 
thanks to the telescope 
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Computerised telescopes and telescope mounts 
either make use of USB or RS-232 connectors for 
hardware to interact with it. For USB, you may just 
need to provide external power, as well as plugging 
in to Raspberry Pi, but for RS-232 you may need 
more specialist hardware, such as the Pegasus USB 
Control Hub: magpi.cc/pegasususb 
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Powering a telescope 








From ast rry.io you can find the image to download to install 
Astroberry Server using Raspberry Pi Imager (magpi.cc/imager). After 

a first boot, you can connect via the Astroberry wireless hotspot, using 
astroberry as the password, and head to : rry.local in your browser. 
You’ ll be able to configure the system from here, including giving details on 
your telescope hardware to make it easier to control via INDI. Refer to the 
Astroberry Server documentation for more info. 


Astroberry comes with a variety of software that allows you to track 
celestial objects and take photos — such as KStars which comes with 
specific Astroberry drivers, several pieces of imaging software for image 
stacking and tweaking exposure. 

Connecting a Raspberry Pi Camera Module or HQ Camera to the 
viewfinder will allow you to use the telescope and automated systems for 
fantastic images — just make sure to weather- proof it! 








What to look out for while stargazing over the next year 
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This meteor shower is 
created by dust particles 
from a comet, and will be 
mostly visible around the 

Lyra constellations 





Mercury at 
Greatest Western 
Elongation 


Mercury will reach its greatest 
eastern elongation of 23.2 
degrees from the Sun, another 
great time to look at it. On this 
occasion, it will be visible to the 
east before sunrise 


16 June 
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Mercury will reach its 
greatest eastern elongation 


of 20.6 degrees from the Sun, 


making it a fantastic time to 
look for it. It will be low in the 
western sky after sunset 


i, st, ~ =5 
370 Ar 


A-~ ava | 
a — | rpP | | 


Delta Aquarids 
Meteor Shower 


From comets Marsden and 
Kracht comes this meteor 
shower, which you'll mostly 
see around the Aquarius 
constellation 


28-29 July 
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A meteor shower from 
dust left behind by Halley's 
Comet, which you'll be able 

to mostly see around the 

Aquarius constellation 


Perseids 
Meteor Shower 


A highly visible meteor 
shower from Swift-Tuttle, 
perfect for a nice summer 

evening. The near-full Moon 
might disrupt it a little, but 
look towards the Perseus 
constellation nonetheless 


12-13 August 
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The Moon will be 
completely obscured by the 
Earth tonight, giving it a dark 

red colour. It will be visible 
tonight throughout all of 
North America, Greenland, 
the Atlantic Ocean, and 
parts of western Europe and 





western Africa 
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Saturn at 
Opposition 


The closest Saturn will get 
to Earth this year, making 
for the best time to get 
some photos of probably 
the prettiest planet in our 
system, and you can see it 
all night long 


14 August 
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Mercury is back, and this 
time it will 27.3 degrees 
from the Sun. Look to the 
west after sunset again 
for this one 


Like Neptune, Uranus is 
extremely distant, but this 
will be the night when you 
can get the best view of it. 

Again, it may just be a small 
blue-green dot 


The final planet in the Solar 
System will be at its closest 
tonight, and visible all night 
long. It's extremely far away 
though, so you may only get 
small blue dots for photos 





Look to the Leo constellation 
for this particular meteor 
shower. It peaks every 33 

years, although the last one 

was in 2001, so it may not be 

as amazing as the Perseids 
shower earlier in the year 
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Our big pal welcomes us 
to autumn, and will be at 
its closest point to Earth 
tonight, and with a medium 
telescope you'll be able to 
get some stunning photos 
all night long. You can even 
check it out with binoculars! 
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Our neighbour planet 
will be very close tonight 
and, with a decent 
telescope, you'll be able 
to get some stunning 
shots of the red planet 























Asmaller meteor shower 


which is best viewed in the 


early evening, in a place 
with as little light pollution 
as possible. Look towards 


Draco for most of the shower 





Brave the cold for one 
of the best shows of the 
year, with roughly 120 
multicoloured meteors 
expected to fall every 
hour. Look towards 
Gemini, but be prepared 
for them to come 
from anywhere 





FEATURE | MagPi 






















FESS! oie ros iveulye loeldng Gare bets Another total lunar eclipse 


ongation Another meteor shower challenge, this small meteor will occur, Ub time in the 
originating from Halley's shower will be taking place on Seavert Fenigatere, Loch 

me! CuLy We vele Comet, you'll find most a near-full Moon and radiating Opto EI eas teny ues 
MEME ea Pe otek of them around the Orion from the Taurus constellation. egbelegtst sue Ge eocis 
sunset, with a western constellation this time With some patience, you may Ocean, and parts of western 


elongation of 18 degrees and central North America 


get a nice spot 
from the Sun 








Mercury at Mercury at 
Greatest Eastern Greatest 
Elongation and Eastern 
Ursids Meteor Quadrantids Elongation Mercury at 
Shower Meteor Shower Greatest 
ie Mercury is back Ww 
On the shortest day of the year, The first meteor in the west after estern 
you can get another chance BOWES of the year sunset, with a 19.2 Elongation 
to view Mercury (to the west is larger than some degree elongation 
after sunset) and meteors from and will tend to be from the Sun The end of winter 
the comet Tuttle. It's a small seen from Bootes, brings one last 
shower, but the Moon will be but can be seen Mercury viewing 
dark and leave the night sky anywhere in the time, just before 
open for some visible meteors, night sky sunrise to the east 


mostly around Ursa Minor 








Pecember 3-4 January 





7 January 16 February 
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SBitDo Arcade Stick 


> SBitDo » 8bitdo.com P» £78/S90 





DIMENSIONS: 
303 x 203 x 
111.5mm 


WEIGHT: 
2.1kg 


CONNECTIVITY: 
Bluetooth, RF 
(through included 
dongle), wired 

via USB 


MACRO 
BUTTONS: 


2 


BATTERY: 
1000 mAh Li-ion, 
30-40 hour 

play time 


» Thebuttonsusea 


tried and tested layout, 
while the switches are 
unique to the way the 
stick works 





A classic console colour scheme on a very modern arcade stick. 
Can Rob Zwetsloot put it through Its paces? Sure he can! 


Sticks has been an interesting one over the 
last decade — while in the West arcades 
are few and far between, there are people still 
interested in playing games like they did in the 
arcade. Whether they’re hobbyists enamoured with 
the classic style, or hardcore players in the fighting 
game community (FGC), there will always be 
people looking for one. Raspberry Pi retro gamers 
are no different. 
8BitDo have answered with their own stick 
simply called Arcade Stick. Like their other 
controllers, it’s fairly platform-agnostic, making 
it playable on a Switch or PC — and that includes 


T he market for high-quality arcade/fight 


SU OFF x 1s DP ie 


BT 2.46 SELECT 
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Raspberry Pi. It uses XInput, the Xbox 360 
controller API, allowing you to use it with very 
little hassle in a vast majority of games, whether 
you’re using RetroPie or Steam Link. The eight 
face buttons map the major buttons on all modern 
controllers, and it includes two programmable 
macro buttons, switches to change how the stick is 
defined, and a couple of extra function buttons for 
Start, Select, Home, etc. 


Connect it your way 

There are three ways to connect the stick toa 
Raspberry Pi, each of them good in its own way. 
While technically the fiddliest way to connect 


pe eeiees 
ARCADE STICK 











is via Bluetooth, it does mean you get a wireless 
connection without having to use a dongle. 
Speaking of dongles, there’s a little RF receiver 
tucked behind a door on the rear of the stick that 
come pre-paired. Plugging it into a Raspberry Pi 


It feels weighty and sturdy, 
and doesn't slip easily if 
you plan to place it ona 
table instead of your lap 


and flicking over to 2.4G allows you to immediately 
use it wirelessly without any Bluetooth hassle, and 
it works really well. It also comes a USB-C cable 
which can be stored before the same door, which 
also houses the wires connection — just in case 

you need to perform that frame-perfect parry of 
Chun-Li’s Houyoku Sen without wireless lag. 

It feels weighty and sturdy, and doesn’t slip 
easily if you plan to place it on a table instead of 
your lap. Like a lot of modern arcade sticks, you 
can also customise and swap out the buttons and 
joystick. The included square-gated joystick and 
buttons are fine, but feel a little loose for our 
liking, and if we were going to start using it ina 
professional setting, we’d definitely replace the 
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internals with some high-end Sanwa parts for 
more Satisfying presses. 

For the price though, you’re getting a very 
flexible, and still very good, arcade stick. Sadly, 
like the Pro 2 controller we reviewed last issue, 
the macro buttons cannot be programmed on 
Raspberry Pi. However, there is a turbo button that 
you can use at any point, so there is some minor 
customisation you can do. 

Overall, we love it. It feels like a quality piece of 
kit, and performs as such too. We’re also keen on 
the use of switches rather than cheat code-esque 
button combos to change functionality, like in the 
last generation of 8BitDo products. Now, excuse us 
as we go take down Shadaloo. 


8BitDo Arcade Stick 


MagPi 


Like all good modern 
fight or arcade sticks, 
you can easily swap 
out and mod the 
buttons and stick 


The included RF 
dongle makes it very 
easy to plug and 
play remotely 


Verdict 


An exceptionally 
solid arcade 

stick let down by 
some mildly fuzzy 
buttons, which will 
admittedly only 
bother a minority 
of players. 
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Weather HAT + 
Weather Sensors Kit 





SENSORS: 
Wind speed, 
wind direction; 
BME280 
rainfall, 
temperature, 
pressure, 
humidity; LTR- 
559 light sensor 


FEATURES: 
1.54-inch colour 
LCD, 4 x push- 
buttons, 2 x 
RJ11 sockets, 
on-board 
Nuvaton 
microcontroller 
with 12-bit ADC 


EXPANSION: 
4 x analogue 
inputs, l2C 
header 


» Therear ofthe 
Weather HAT. It will fit 
any 40-pin Raspberry 
Pi modeland also 
features an l2C header 
for extra inputs 


> Pimoroni » magpi.cc/weatherhat P» £83/$94 


Come rain or shine, you'll Know all the details with this 
fully-fledged weather station, By Phil King 


e’ve seen various Raspberry Pi DIY 

weather station projects and commercial 

kits before, but the Weather HAT makes 
setup a whole lot easier. 

For starters, the board features standard 
telecoms-style RJ11 ports that enable you to just 
plug in the connectors from the wind speed, wind 
direction (vane), and rainfall sensors. Similar to 
the ones formerly available from Maplin stores, 
these three plastic sensors are provided in the full 
Weather HAT kit - or, if you already have some, you 
can buy the Weather HAT on its own for £36 / S41. 

Secondly, the Weather HAT has an on-board 
Nuvoton microcontroller with a 12-bit ADC to read 
analogue signals from the sensors reliably. A nice 
bonus is that four extra analogue input channels are 
broken out in an unpopulated header on the bottom 
edge of the board (along with 3V and GND), so you 
could add extra sensors. Not only that, but there’s 
an 12C header on the underside of the board. 











Monitor wind 
strength/direction 
& rainfall alongside 
light and humidity 
temp and pressure 


BMOLBHAS | 
Made in Sheffield, UK | 


Fu 





bed a 


0900000 
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Whether you’ ll need extra sensors is a moot 
point: the HAT already incorporates a standard 
BME280 temperature, pressure, humidity sensor 
and an LTR-559 light sensor — as featured on 
Pimoroni’s earlier Enviro boards. A1.54-inch 
colour LCD screen completes the package, with 
four tiny push-buttons around it. 


Station setup 

Assembling the weather station takes only around 
15 to 20 minutes. The wind direction and speed 
sensors are screwed onto either end of a sturdy 
plastic arm that fits into the top of a two-section 
hollow metal mast. A shorter arm is clamped to the 
mast and holds the rain sensor. We then planted 
the metal mast into some garden soil, but clamps 


South West 





A lt'svery easy to hook your weather station up to an 
Adafruit |O web dashboard to log all the data there 


are also supplied in case you want to 
secure it to a drainpipe or something similar. 

As mentioned, the sensors’ RJ11 connectors 
simply plug into the labelled sockets on the 
Weather HAT. If you’re wondering why there are 
only two sockets, this is because the wind speed 
sensor’s connector fits into a socket on the wind 
vane, and then wires from both are routed to one 
RJ11 connector into the HAT. 

The cables are approximately 3m long, so 
unless you use extenders, your Raspberry Pi needs 
to be located fairly close by. Naturally, if this is 
outside, you should place it in a weatherproof 
box (not supplied). You may also need a mains 
power extension. Alternatively, you could place 


M™ The sensors’ RJ11 
connectors simply plug into 
the labelled sockets on the 
Weather HAT @ 


your Raspberry Pi indoors, although you then 
wouldn’t get accurate outdoor temperature and 
humidity readings. 


Software library 

As usual from Pimoroni, there’s a fully-fledged 
Python library for the Weather HAT, complete with 
code examples. The main weather.py example 
shows readings from the sensors on the mini 





A. The weather.py Python code example shows 
live data from the sensors on the LCD 
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LCD, with push-buttons used to switch between 
individual sensor readings and between a digital 
readout or bar graph. We particularly liked the 
wind display, with an arrow rotating to show the 
direction, its size indicating the speed. Note that 
you may well need to use a compass and rotate the 
metal mast so that the wind vane is oriented to 
obtain accurate direction readings. 

In the long term, you will want to keep a log of 
your data and view it on a web dashboard, which is 
where the Adafruit IO code example comes in. Just 
sign up for a free account at adafruit.com and you 
can build your own custom dashboard from preset 
blocks such as line graphs and gauges, linking 
them to the already created feeds coming from 
the Weather HAT. Within minutes we had our own 
weather web dashboard set up. Hl 
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A Along with on-board sensors and a mini LCD to 
show data, the Weather HAT has inputs for wind and 
rain sensors, plus a breakout header 
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<q The Weather Sensors 


Kit comprises wind 
speed, wind direction, 
and rain sensors, 
mounted ona 

metal mast 





Verdict 


Packed with all 
the features and 
expandability you 
could need, this 
comprehensive kit 
is very good value 
for money and 
makes it a breeze 
to set up your own 
weather station. 
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Tiny 2040 





> 
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CONNECTORS: 


16 x pins 
including 12 x 
GPIO, 3-pin 
debug header, 
USB-C port 


RAM / 


STORAGE: 
264kB SRAM, 
2MB or 8MB 
QSPI flash 


FEATURES: 
Reset and boot 
select buttons, 
RGB LED, 4 x 
12-bit ADC 
channels, PIO, 
l2C, SPI, VART 


DIMENSIONS: 


22.9 «x 18.2 x 
6mm 


“| can do anything you 


can do smaller!" The 


Tiny 2040 is a fraction 


of the size of a Pico 


> Pimoroni » magpi.cc/tiny2040 » From £7/S$7 


A truly tiny RP2040-powered microcontroller board. By Phil King 


of gum, but if you need an even smaller 

microcontroller, the Tiny 2040 could fit 
the bill. Roughly the dimensions of a regular UK 
postage stamp, this little board is about 40% the 
length of a Pico, but packs the same powerful 
RP2040 system-on-chip. 


M The Tiny 2040 adds a 
very welcome on-board 
reset Button, which saves 
repeatedly unplugging it @ 


R aspberry Pi Pico is only the size of a stick 


You can flash it with the Pico firmware 
and program it with MicroPython, C/C++, or 
CircuitPython. So it’s very versatile and easy to 
get started with. 

To achieve a smaller footprint, a few 
compromises have been made. Most notably, the 
Tiny 2040 only has a total of 16 pins versus Pico’s 








40, plus a debug header. Of these, there are 12 
GPIO pins, compared to 26 on Pico. So it won’t be 
compatible with most Pico add-on modules. As 
with Pico, there’s no wireless connectivity. 

On the plus side, the Tiny 2040 does break out a 
fourth ADC input — which is connected to an on- 
board temperature sensor on Pico. 


Tiny choices 
You can buy the Tiny 2040 with or without 
(2.54mm pitch) header pins attached. There’s 
also a choice between 2MB of on-board QSPI flash 
storage (as on Pico) or 8MB. The Tiny 2040 is a fair 
bit pricier than Pico itself, which is only £3.60 / S4. 
On the plus side, the Tiny 2040 adds a very 
welcome on-board reset button, which saves 
repeatedly unplugging and reconnecting the board. 
There’s also a programmable RGB LED (linked to 
three internal GPIO channels), rather than the 
single-colour green one on Pico. 
Other than that, its advantages are mainly 
down to its diminutive size, making it suitable 
for wearable projects or even a tiny robot (e.g. 
magpi.cc/tiny2040robot). While not quite as 
minuscule as a Nionics Atto or Seeeduino XIAO, its 
RP2040 chip is a lot more powerful. H] 





Verdict 


Perfect for 
wearables and 
other portable 
projects, it packs 
the same RP2040 
SoC as Pico but 
ona much smaller 
board, plus a few 
bonus features. 


8 i 





A. TheRP2040 SoC is located 
on the underside, which may 
make the board a little trickier 
to surface-mount 


SUBSCRIBE AND 


SAVE‘: 
3% 


on the cover price 


MAKE BUILD HACK CREATE ! 


TECHNOLOGY IN YOUR HANDS 


Hackspace 


> LEOS AMALODUL APORS EL Yon! 


age 


4 Available on the 


nPP Store 
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Bacger 2040 


> Pimoroni » magpi.cc/badger2040 P» £12/S16 





SCREEN: 
2.9-inch black 
and white e-ink 
display (296 x 
128 pixels) 


PROCESSOR: 
RP2040 

(dual Arm 
Cortex-Mo+ 
running at up 
to 133MHz 
with 264kB of 
SRAM); 2MB 

of QSPI flash 
supporting XiP 


1/0: 

Five front 

user buttons; 
Reset and boot 
buttons; White 
LED USB-C 
connector for 
power and 
programming; 
JST-PH 
connector 

for attaching 

a battery 
(input range 
2.7V -6V) 





Verdict 


Badger 2040 is a 


fun accessory that 


integrates nicely 
with Raspberry 
Pi thanks to its 
RP2040 base. 
Simple to set 
up, but a lot of 
potential for 
integration with 
your projects. 
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Raspberry Pi 2040-based e-ink badge and buttons 
make for an interesting device. By Lucy Hattersley 


of Raspberry Pi Pico, and it’s making its 
way across the tech ecosystem, powering a 
range of unique devices. 
Badger 2040 is an RP2040 mounted on a 2.9-inch 
black and white e-ink display with five buttons. 
The device comes fully assembled, so all you need 
to do is turn it on and load up the latest version of 
the software from Pimoroni’s GitHub page (magpi. 
cc/pimoronipicoreleases). Installation is a case of 
holding down the BOOT button to mount RP2040 
onto the destkop, and copying the UF2 file to the 
mounted storage. 


R aspberry Pi 2040 is the chip at the heart 


There’s an app 
There is a clock app, ebook app (pre-loaded with 
Wind in the Willows), an image app, interactive list 
app, badge app, along with a QR code, info, and 
help information displays. 

As with many projects, the fun begins 
when you Start exploring what you can do 
with Badger 2040 in a coding environment. 
Pimoroni’s documentation is, as typical, 
excellent, including a Getting Started with 
Badger 2040 guide (magpi.cc/getstartedbadger). 
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A. Badger 2040 features an e-ink display and five navigation buttons 


. https://pimoroni.com -, 
40 : 





A. Onthe rear of Badger 2040 sits the RP2040 chip along with BOOT 
and RST buttons and a white LED 


M An optional accessory 
kit includes aq AAA 
battery holder @ 


The tutorials take you through writing ‘Hello 
Badger’ to the screen and customising the default 
apps. This is done by exploring a range of text 
files in Thonny (using View > Files). Images can be 
converted using Pillow and the convert.py file 
An optional accessory kit includes a 
AAA battery holder and batteries, 
Velcro square, lanyard, and cable. 
You can also power Badger 2040 by 


: connecting a lithium battery to the 


JST-PH connector. 

Moving on from the default Badger 
OS and test projects, Badger 2040 
has a Qwiic/STEMMA QT port for 
connecting breakouts with a JST-SH 


| cable and STEMMA QT adapter 


(magpi.cc/stemmagqt). With this, 
you can explore integration witha 
variety of sensors, breakout boards, 
and accessories. Hl 





QuickStart guide to setting up 
your Raspberry Pi computer 


Updated with Raspberry Pi Pico 
and all the latest kit 


The very best projects built by 
your Raspberry Pi community 


Discover incredible kit and 
tutorials for your projects 
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10 Amazing: 


Robot 
projects 


Create an gutomaton 
with Raspberry Pl 


hand for years, with projects, kits, racing 

tournaments, and even battles coming from the 
marriage of microcomputers and mechanics. There’s 
never been a better time to try and build one yourself, so 
here are ten amazing projects you can try! 


R obotics and Raspberry Pi have gone hand in 





4 Yuri 3 


Rover doppelganger 


This six-wheeled robot takes inspiration from the ExoMars rover, 
a future rover planned to be sent to Mars at the end of 2022. This 
version stays on Earth though. 


magpi.cc/82 
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Torso robot 


This amazing-looking robot is very 
interactive and can play games 
and talk with its owners. It’s also all 
powered by a Raspberry Pi 4. 


magpi.cc/reachy 





4 DoodleBorg 


Giant towing robot 


From the incredible folk at PiBorg, this monstrous robot is powerful enough to 
tow caravans — as you may have guessed from the trailer hitch on top. 


magpi.cc/doodleborg 





4 Build a robot buggy 


Your first robot 


A great project for building your very first robot, created by the Raspberry Pi 
Foundation. It’s simple and easy to follow. 


magpi.cc/robobuggy 





Expendable mine sweeper 


This cardboard-based robot is cheap, quick to make, and easily replaceable if it 
has to take a trip to circuit heaven after completing its explosive job. 


magpi.cc/cturtle 


4 Ping Pong Pursuit 


Tidy up time 


This robot uses a lot of 3D printed parts and a camera to clean up ping pong 
balls in the 37signals office in Chicago. 


magpi.cc/pingpongbot 


> PARSLEE 


Earth rover 


This happy robot was made by Dr Jamie 
Molaro, a NASA scientist, and it includes 
a seismometer to record earthquakes 
and other seismic activity. 


magpi.cc/83 
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4 PiMowBot 


Automated green keeping 


Take the concept of a Roomba robot vacuum cleaner and add 
some powerful spinning blades to its underside, and you get 
PiMowBot - although there's a lot more to it than that. 


magpi.cc/pimowbot 









>» Project Zed 


Intimidating citizen 
encouragement 


This upcycled robotic wonder 
was built to help aid people 
when human contact might not 
be a good idea. It uses machine 
learning to give it a bit of 

a personality. 


magpi.cc/projectzed 


> Build a line-following robot 


Simple robot project 


This project from the Raspberry Pi Foundation is a great follow-up 
to the ‘build a robot buggy’ project, which lets you add some 
automation to the buggy. 


magpi.cc/linefollow 
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RESOURCES 


Learn Java 


with Raspberry P1 


Start coding in Java on Raspberry PI 
with these resources, By Phil King 


CodeGym 


Price: 
Free trial 7 $50 pcm 





codegym.cc 


CodeGym 


Created by Sun Microsystems 
in 1995, Java is now one of 
the world’s most popular 
programming languages. 
Object-oriented, it’s highly 
versatile and fairly easy to 
learn. You can code with it on 
Raspberry Pi using Visual Studio 
Code (or another suitable IDE) 
to create applets that will run on 
any machine with Java Runtime 
Environment installed. 

One of the best ways to start 
learning Java is to get coding. 






CodeGym is a practical, gamified 
course that involves solving 1200+ 
hands-on tasks of increasing 
complexity in a web IDE. At the 
start, you’re asked which learning 
style you prefer and whether you 
have any previous Java experience 
— a mini quiz determines your 
current level. ‘Dark matter’ 


Free online courses 





Study Java with these free courses 
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EDX JAVA 

On the edX site, you'll find a wide 
range of Java-based courses 
from top educational institutions 
- from introductory guides and 
fundamentals to more specific 
topics, such as data structures 
and algorithms. 

> magpi.cc/edxjava 


INTRODUCTION TO JAVA 
Created by Duke University, this 
beginner's course is available for 
free on Codecademy. As usual, 


earned from completing lessons 
and tasks is used to unlock the 
next ones. 

While the first level of lessons 
is free, you’ ll need a paid 
subscription (or access via your 
educational establishment) to 
access the rest, but it’s ideal 
for beginners. Hl 


a web IDE lets you write and run 
code, and the course covers all the 
fundamentals of Java. 

> magpi.cc/codecademyjava 


JAVA MULTITHREADING 
Uncover the mysteries of 
multithreading - executing two or 
more threads simultaneously on the 
CPU - with this three-hour video 
course aimed at coders with existing 
Java experience. 

> magpi.cc/javamulti 





Java: A | 
Beginners Guide 


Herbert 
Schildt 


For those who prefer a textbook 
to help get started with Java, 
this is one of the best. Now in its 
Price: ninth edition, it guides you step- 
ee ede by-step through the learning 
process. Throughout, there are 
self-tests and projects to try. 
Starting with the 
fundamentals of Java and 
object-oriented programming, 
the book introduces the reader 
to data types and operators, 
program control statements 
(such as loops and conditionals), 
and then classes, objects, and 
methods. After elaborating 
further on these, it moves on to 
cover inheritance, packages and 
interfaces, exception handling, 
and I/O. Advanced topics include 
multithreaded programming, 





magpi.cc/ 
javabeginners 


Coderanch 


Coderanch Whenever you have a problem 
. with your Java code, getting 
di some advice from more 





experienced programmers 

and developers is invaluable. 
As with other programming 
languages, there are numerous 
online forums to help you out, 


coderanch.com 


‘Should woe foe mech or Por oes Be rer ery 
hi-—-« — si 


eT age 





Java 
A Beginner's Guide 


Ninth Edition | 





Herbert Schildt 


generics, lambda expressions, 
and modules. The final chapter 
introduces the Swing GUI toolkit 
for Java. 

It should certainly give 
you a good grounding, after 
which you may want to check 
out the author’s Java: The 
Complete Reference. fil 


including the trusty Stack 
Overflow and the official Oracle 
developers community. One 

of the most beginner-friendly 
forums can be found at the 
Coderanch. Despite the Wild 
West theme, it’s a hospitable 
place for newcomers, moderated 
by volunteer marshals and 
sheriffs. There’s even a 
Beginning Java subforum to help 
you get established. 

In addition, among the wide 
variety of topics covered on the 
Site are book reviews, career 
advice, mobile, databases, 
caching, build tools, and 
frameworks. Hit the FAQs button 
at the top left to view a range of 
useful wiki articles. H 
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Books for learning 
gbout Java 


A Brain-Friendly Guide 





HEAD FIRST JAVA 


Written in an entertaining 


style, this beginner's book 
offers a seriously good 
introduction to object-oriented 
programming and Java. Short 
stories and puzzles help to 
keep you engaged. 

> magpi.cc/headfirstjava 


EFFECTIVE JAVA 

Aimed at experienced Java 
developers seeking to improve 
their code, it explains 90 best 
practices to follow. These 

are organised into sections 
such as methods, generics, 
concurrency, and serialisation. 
> magpi.cc/effectivejava 


JAVA PUZZLERS 

Even expert Java coders can 
get tripped up by oddities 

of the language. This book 
addresses common traps, 
pitfalls, and corner cases via a 
series of 95 puzzles to educate 
and entertain. 

> javapuzzlers.com 
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> The first computer Mike 
ever made in 1976, just 
from a datasheet 


86 | magpicc | Mike Cook 


Mike Cook 


Veteran maker and previous writer of our Raspberry Pi 
Bakery series, here's the story of Mike Cook 


> Name Mike Cook | 
> Community role Maker | 
- could find a wonderful 
tutorial from Mike Cook 
and his Pi Bakery right here in 
the pages of The MagPi. From 
dancing skeletons to handmade 
MIDI guitars, he showed readers 
how to create an incredible 
variety of projects. He’s well- 
known to older readers from 
his regular columns in The 
Micro User and Acorn User in 
the 1980s. 

“Tam addicted to making 
stuff,” Mike tells us. “Now 
retired, but I was a university 
lecturer for 21 years and 
an electronic engineer ina 
mass-production consumer 


electronics company for the rest 
of my career.” 


or avery long time, you 





> Occupation Retired journalist 
> URL magpi.cc/mikecook 


What is your history with 
electronics and programming? 
My first electronic kit was called 
Trans Tronic. I got it when 

I was nine, and was making 

and selling crystal sets to my 
classmates when | was 13. Left 
my secondary modern school 

at 16, although 14 was the 
minimum school leaving age 
then. I went to work for a local 
industrial electronics company. 
There I did day release and night 
school for an ONC qualification. 
This allowed me to attend 
Newcastle Polytechnic, where | 
took a joint degree in Physics/ 
Electronics. This is where I had 
my only formal education about 
computers. I had three one- 
hour lectures on programming 


with Fortran IV, but that was 
enough to get me hooked. 


When did you start writing 
about it? 

After I made my own computer 
in 1976, from just a datasheet 

of the processor, and no idea 
what software did in them. 

My first published article on 
computing was in 73 Magazine, 
a ham radio magazine from 

the USA. It was about making 
music with a microcomputer. 
Later, I went on to write about 
the BBC computer in The Micro 
User, and after that in Acorn 
User. My first publication was in 
The MagPi #5, but I didn’t start 
writing my Pi Bakery series until 
The MagPi #33 (magpi.cc/33). 





MagPi 


Dancing Skeletons is 
very much a favourite at 





The MagPI 

When did you learn about Cassegrain telescope. I stained glass work, and 
Raspberry Pi? even lectured in it as part of hill walking. 
From a blog post online about the physics courses at the 
six months before it first came university. Speleology, although Anything else you’d like 
out. I wasn’t quick enough to get it is some years since my wetsuit to add? 
one of the first batch, although! actually fitted me. Photography, __I[ just love helping people with 
did apply for, and got, asecond- analogue stuff with trays of their projects. There was no 
batch machine. chemicals. I was a professional ‘online’ when I started, and so 

wedding photographer for three _—[ had to work it all out myself. 
What was the first thing you years in the late 1960s. Also, It is good to give people a taht a Ae 
made with a Raspberry Pi: amateur radio, live music gigs, helping hand. older glockenspiel project 


I adapted a project I had done in 
The Micro User for a computer- 
controlled glockenspiel. 


What is your favourite thing 
you’ve made? 

What, just one? Too hard, you get 
eight on Desert Island Discs. Well, 

I will give you my top three. 
Dancing Skeletons — The MagPt 
#50 (magpi.cc/50), Tap-n-LED, 
— The MagPi #97 (magpi.cc/97), 
and Pico Voice — The MagPi #106 
(magpi.cc/106). 


What other hobbies have 
inspired you? 
Astronomy. I have a 10” 
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MagP1 
Monday 


Amazing projects direct from our Twitter! 





very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. 
Here’s a selection of some of the awesome things 
we got sent this month — and remember to follow 
along at the hashtag #MagPiMonday!! 





01. Pico and micro:bit working together? Not 
as strange as you think. 


02. Thisis one way to appreciate every shot 
from Raiders. 


03. We think it's a bad idea to create the villain 
that helped form the Justice League, but it 
iS COOL 


04. What a cool and impressive use of 
computer vision! 


05. This is an impressive first project! A nice 
robot to test with. 


06. Avery cute musical project with cool lights. 


07. Kevin's cluster computer has been getting 
bigger and better. 


08. This wall control is very smart and full of 
cool functions. 


09. Cute cat robot that helps you learn to 
code? Incredible. 


10. Wewonder if this can also power a 
Raspberry Pi. 


11. PiWars continues in Puerto Rico. 
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Starro mask with moving eye, run off a RPi Pico 





éy Lorraine Undervood 


Oh | got a Pico talking to a microbit over jacdac which 
was cooll 
All prototyping for a new board i'm creating 





Nothing fancy, but it brings me joy: A slow movie 
player. 






Pj zero, waveshare e-ink, battery. 







critterd? 






fitter? 





=a Brian Starkey 
Sreédbytes 
ms 


tong to ST halos 


| got my Pico-powered robot following 4 coloured blob 
using an OV7670 camera and PIO @ 


: Splke Tecunycn 
= 


First pl project, based on Maker RP?040 board. 
@ Brian Starkey Gusedbyres - lan 23 
ATA? am extremely Iruetrating week of debugging electrical issues, this is 
intensely satietying @) Everything being Gone by a @Razobey Fi Pion hyhect is 


ieee! “Pinel fie ef el" takes <2 us) Pars 





&= Kens McAleer 


The Mare 


This weekend | was at the @raspberrypi exhibit launch, 
but | did manage to take this photo of the Clustered-Pi 
(12 raspberry pi zero 2w's) on the Cray-1 that inspired 
it! #raspberrypl #MagPiMonday #retro ' 
#retrocomputing clustered-pi.com hep 





MrTonyoo? 


EhArTony Oe? 





Replng to ThehigePy 


Wall terminal built with RPi, official touchscreen, pir 
motion sensor, camera, RFID sensor, fingerprint 
scanner and speaker. Placed in custom 3D printed 





Alam 
Ga? Geeomarster 


Renhing te The Magri 


Cam BDavidson-Filon 
P gm _DP 


Replying fo iT heWagri 


Building a bioreactor on top of a Raspberry Pi! 





& Pioreactor 


enclosure. Using it to ma nage the alarm in particular. 





MagPi 


Awd as 
z, AeA 


Rephyaine, fo 


| worked on improving last week's Pico MIDI ta CV 
interface by adding a calibration pot, a second CV 
output, an LDR to control it and some NeoPixels to 
show the currently playing note. And | made a tune to 
celebrate my favourite microcontroller's birthday. 


ip Jacko Thiet fae 1 


Reading to AiResoiecrry Ps 


Happy First Birthday Getiapherny Fi Pool 

To celebrate | adced a gecond CHC, an WOR acd some blinders ants te ny Pica 
[AEICH f tra ores Dest Sv fSeruTbeall a fie Oa say cetiy boar Chen of, Hope 
‘yt Ure It 

#fnsphe! . Pies FR 








@- Toe hae varpeainnete) 
i Lip Lae 


OT hee bln 


Mini Pi Pico companion bots for my year 8 classes. 


Teaching them how to code + connect a servo and 
neopixel then 3D design and print a face for it. 





Yess! Getting ready for PiWars 
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Or Footleg - Roboteer 


Barfocticg 








Rephing to OTheWMagPhi 





with TPU treads. #MagPiMonday 






@ Or Footieg - Roboteer drfootleg : Jan 25 





Shou hes (Prt 


Andy Piper @andypiper - Jan 31 
ray Replying to @TheMagh 


Spent some time with my GPi Case 2 (Pi Zero 7 W inside), does that count? 








12. 


13. 
14. 
15, 


16. 


17. 


This robot could probably go up a near 
vertical slope. 


Portable retro gaming at its finest. 
A great way to upgrade your GPi. 


This is a macro keyer, which we think is 
used for ham radio stuff. 


A genius use of Sense HAT, Build HAT, 
and Wordle. 


This 3D-printed case is a very cool idea. 


90 | magpicc | MagPi Monday 







| got the first track running for my next Raspberry Pi 
robot. Printed on my dual material 3D printer in PLA 






Thés 16 golng to be an absolute beast with these motors! So much torque | can't 
Stop them wath oy hands, Fingers will need to be kept clear when Ue is nonin 


Raul Portales 
isla_shalafi 


Replying to @TheMagPi 


Just a simple retro gaming system with a carry bag. 
Loving the Nes3Pi case. 












Zero Retries Newsletter 





Built from wbhifhc.com/intro.html 










Richard Hayler © 
@rdhayler 


Replying te 'TheltagP 







| made a silly machine that uses a Sense HAT and Build 
HAT to tweet a photo of my daily #wordle result as 
displayed on the LED matrix. 











Rincewined 
rincawandsO1S 


Replying to @The agri 









Completed my Raspberry Pi server. Now using it to 
learn some simple electronic projects. #!\iagPiMonday 
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UHF HAT 


Created by SB Components, the UHF HAT for Raspberry Pi 
is “an advanced and compact ‘Ultra High Frequency’ RFID 
reader that consists of powerful RFID technology [designed] 
for a broad range of applications...” 


Pico 87 Mechanical Keyboard 







Customisable keyboards are pretty cool, and in this case you can even 
customise what every single key does, not just change the caps. There's also 
a detachable number pad and some USB ports connected to it. 


>» kek.st/3LT38tF » kck.st/3AVq7zc 





POD MODULES 


Ms Magri | YOUR LETTERS 


Your 


Letters 








V Allour magazines are available for free as a PDF 
from our website 





First tutorials =" = 2 


I have been looking for some kind of guide or book or website for absolute = ———] 
beginners to Raspberry Pi as my teenagers have recently got into programming Mage iu Mag’ bie 
and got a Raspberry Pi for Christmas. Do you have any suggestions on issues 7 


they could look at, or other places? 
Read for free 


Nes vid emall 





Are you still doing free PDFs for your 

We have a few books that may be of interest. magazine? Do I need to sign up 
The Raspberry Pi Beginner’s Guide 4th Edition anywhere to get them? 
(magpi.cc/bguide4) will guide you through 
getting started with a Raspberry Pi, and even 
has some basic projects to get on with. 

If they pick up things very quickly, there’s 
always The Official Raspberry Pi Handbook 
2022 (magpi.cc/handbook2022), which has 
a quick getting started guide, as wellasa 
load of tutorials to be inspired by and learn 
how to do. 


There’s also the For Home _‘ The Official Raspberry 
Pi Handbook 2022 is a 


Miles Vid email 


All our books and issues are released 
as a free PDF on the same day as the 
physical copy of the magazine! You 
can always find them on the page for 
each issue at magpi.cc/issues, but we 
also provide a link in the newsletter 
on the same day so that you kinda get 





section at raspberrypi.com, great way for those who it delivered to you through there. You 
which can help you out with aie eaigeonie can sign up to our newsletter using our 
loads of online resources. with Raspberry Pi website: magpi.cc. 
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If you'd like a 
Raspberry Pi Zero 
2 W, you can get 
one with a twelve- 
month subscription 
to The MagP!! See 
page 30 for details 


Is there a new Raspberry Pi coming out on Pi Day? I’ve read 
a few rumours that there may be a Raspberry Pi 5 that day! 


Ting Vid Facebook 


If you’re reading this, no, it’s long past 14 March, aka Pi Day 
due to it being 3/14 in the American date format, and as you 
may have seen, nothing was released. Raspberry Pi doesn’t 
really announce items ahead of time so, even if it were true, 
we wouldn’t be able to confirm it! 


Twitter 
Facebook 
Email 
Online 
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SBITDO PRO 2 
CONTROLLERS 


IN ASSOCIATION 
WITH 8BITDO 





XN 





We reviewed the excellent 8BitDo 
Pro 2 controller last issue and 
gave ita 9/10. It's one of the best 
retro game controllers out there, 
with a comfy D-pad and many 
advanced settings. 


Head here to enter: inagpi.ce/win | Learn more: magpi.cc/pro? 





Terms & Conditions 

Competition opens on 30 March 2022 and closes on 28 April 2022. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the prize supplier, 
their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any publicity 
generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details will 
remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Ms THE FINAL WORD 





Rubber Sou! 


Looking after the old and the new 





e have an interesting 
W relationship with nostalgia 
here at The MagPi 


magazine. We like to stay close 
friends with it, but don’t move in 
with it and make ourselves at home. 
In case it gets the wrong idea. 

Which is to say: while we Keep one 
hand firmly on our retro joysticks, 
enjoying and loving the past, we have 
another hand pointing directly at the 
future and are saying, “Look! That’s 
where we belong.” 

This makes sense. Raspberry Pi is 
ideal for rediscovering retro classics; 
its modern processor is capable of 
faithfully emulating just about every 
beloved computer of our generation. 
And like many computer geeks of our 
generation, we loved many different 
8- and 16-bit computers. 

My beloved computer of this 
month is the ZX Spectrum. Which is 
- and I can barely believe I’m saying 
this - 40 years old this April. 

I mean, I know this must be true. It 
had ‘© 1982 Sinclair Research’ on the 
screen every time | looked at it. But it 
can’t be 4o years, can it! 

I first got a ZX Spectrum around 
1984. A wonderful year (despite its 
infamous book namesake). I fell 
in love with prodding the rubber 
buttons and making things move 
around my small black and white 
TV screen. The BASIC programming 
language was - in retrospect - 


98 | Rubber Soul 


absolutely basic. And the gulf 
between BASIC and Z80 machine 
code was depressingly huge. 

And there’s no getting away from 
the fact that computers were sold 
as toys, which meant they became 
heavily gendered. The Spectrum was 
pitched at boys and let’s not forget 
the cliquey club with “no smelly girls 
in our treehouse.” Thank goodness 
those days are over. 

Still, I stuck with my beloved ZX 


version of the classic computer. | 
bought one and I love it. It uses a 
Raspberry Pi Zero inside to provide 
sound support, enabling users to 
load tapes with sound, screeches, 
and all. Meanwhile, a modern FPGA 
(field- programmable gate array) 
reproduces the Z80 chip exactly. 

If you’ve ever loved the ZX 
Spectrum, I wholeheartedly 
recommend you read (Wireframe 
editor) Ryan Lambie’s 


M My beloved computer of this month is 


the ZX Spectrum @ 


Spectrum. Even though its keys were 
squidgy and each button had four or 
five confusing commands printed on 
it. And the Spectrum broke so often 
that the factory, at one point, was 
rumoured to have stopped taking 
returns (because there physically 
wasn’t enough space to store them). 
Mine broke five times before my 
Dad bought me a Commodore 64 out 
of frustration. 


Honour the past 

We’ve honoured the ZX Spectrum 
many, many times in The MagPi 
(and will continue to do so in the 
future). Two years ago, the ZX 
Spectrum Next project (magpi. 
cc/specnext) produced a modern 


wonderful homage to Sinclair 
computing and the ZX Spectrum 
(magpi.cc/wireframespectrum). 
Nostalgia has its place, and I defy 
any Spectrum fan to hear the loading 
screech and not have their heart 
melt. But Raspberry Pi and Raspberry 
Pi Pico are ultra-modern computer 
platforms remaking the modern 
computing landscape. As Eben says, 
“the future of computers is only S4 
away”. That’s the important thing! 


Lucy Hattersley 





Lucy is Editor of The MagPi and loves all 
her retro computers equally, even that 
Dragon 32 in junior school. 
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® Rapid tool-free assembly and disassembly ® Secure microSD card cover 

® Large internal volume for HATs @ VESA mount support 

® Compatible with Pi 2/3/4 ® Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

® Passive & Active Cooling options @ Printed logo for your branding 


| Available at these great Pi stores: | 


al = =a = 
€=PiShop.us {+$PiShop.ca  {*$ PiShop.mx €)zpidut PrSuoe.cn electron. 


Contact your favorite Pi store if it’s not listed here 





